rspec/rules/S2953/csharp/rule.adoc
2022-02-04 16:28:24 +00:00

81 lines
1.2 KiB
Plaintext

``++Dispose++`` as a method name should be used exclusively to implement ``++IDisposable.Dispose++`` to prevent any confusion.
It may be tempting to create a ``++Dispose++`` method for other purposes, but doing so will result in confusion and likely lead to problems in production.
== Noncompliant Code Example
[source,csharp]
----
public class GarbageDisposal
{
private int Dispose() // Noncompliant
{
// ...
}
}
----
== Compliant Solution
[source,csharp]
----
public class GarbageDisposal : IDisposable
{
public void Dispose()
{
// ...
}
}
----
or
[source,csharp]
----
public class GarbageDisposal
{
private int Grind()
{
// ...
}
}
----
== Exceptions
Methods named ``++Dispose++`` and invoked from the ``++IDisposable.Dispose++`` implementation are not reported.
----
public class GarbageDisposal : IDisposable
{
protected virtual void Dispose(bool disposing)
{
//...
}
public void Dispose()
{
Dispose(true);
GC.SuppressFinalize(this);
}
}
----
ifdef::env-github,rspecator-view[]
'''
== Implementation Specification
(visible only on this page)
include::message.adoc[]
'''
== Comments And Links
(visible only on this page)
include::comments-and-links.adoc[]
endif::env-github,rspecator-view[]