CA2015: Non definire i finalizzatori per i tipi derivati da MemoryManager<T>
Proprietà | valore |
---|---|
ID regola | CA2015 |
Title | Non definire finalizzatori per i tipi derivati da MemoryManager<T> |
Categoria | Affidabilità |
Correzione che causa un'interruzione o un'interruzione | Nessuna interruzione |
Abilitato per impostazione predefinita in .NET 8 | Come avviso |
Causa
Definizione dei finalizzatori per i tipi derivati da MemoryManager<T>
Descrizione regola
L'aggiunta di un finalizzatore a un tipo derivato da MemoryManager<T> è probabilmente un'indicazione di un bug, perché suggerisce che una risorsa nativa che potrebbe essere stata distribuita in un Span<T> oggetto viene pulita e potenzialmente mentre è ancora in uso da Span<T>.
Nota
La MemoryManager<T> classe è destinata a scenari avanzati. La maggior parte degli sviluppatori non deve usarla.
Come correggere le violazioni
Per correggere la violazione, rimuovere la definizione del finalizzatore.
class DerivedClass <T> : MemoryManager<T>
{
public override bool Dispose(bool disposing)
{
if (disposing)
{
_handle.Dispose();
}
}
...
// Violation occurs, remove the finalizer to fix the warning.
~DerivedClass() => Dispose(false);
}
Quando eliminare gli avvisi
È sicuro eliminare una violazione di questa regola se lo scopo è creare un finalizzatore per scopi di debug o convalida.
Eliminare un avviso
Se si vuole eliminare una singola violazione, aggiungere direttive del preprocessore al file di origine per disabilitare e quindi riabilitare la regola.
#pragma warning disable CA2015
// The code that's violating the rule is on this line.
#pragma warning restore CA2015
Per disabilitare la regola per un file, una cartella o un progetto, impostarne la gravità none
su nel file di configurazione.
[*.{cs,vb}]
dotnet_diagnostic.CA2015.severity = none
Per disabilitare questa intera categoria di regole, impostare la gravità per la categoria su none
nel file di configurazione.
[*.{cs,vb}]
dotnet_analyzer_diagnostic.category-Reliability.severity = none
Per altre informazioni, vedere Come eliminare gli avvisi di analisi del codice.