Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
CA1517: Usare
| Property | Value |
|---|---|
| ID regola | CA1517 |
| Title | Usare ReadOnlySpan<T> o ReadOnlyMemory<T> invece di Span<T> o Memory<T> |
| Category | Manutenibilità |
| Correzione che causa un'interruzione o meno | Non-breaking |
| Abilitato per impostazione predefinita in .NET 10 | No |
| Abilitato per impostazione predefinita in .NET 11 | Come suggerimento |
| Lingue applicabili | C# |
Cause
Un metodo ha un parametro Span<T> o Memory<T> che il metodo non modifica.
Descrizione della regola
Usare ReadOnlySpan<T> o ReadOnlyMemory<T> per i dati che un metodo si limita a leggere. Il tipo di sola lettura rende chiara la finalità del metodo e consente ai chiamanti di passare i dati che non possono modificare.
Come correggere le violazioni
Modificare il tipo del parametro con la sua controparte di sola lettura. L'analizzatore non segnala metodi che non possono modificare in modo sicuro il tipo del parametro nella controparte di sola lettura, ad esempio metodi virtuali o di interfaccia.
Examples
Il codice seguente mostra una violazione di CA1517:
static int GetFirst(Span<int> values) => values[0];
Modificare Span<T> in ReadOnlySpan<T>:
static int GetFirst(ReadOnlySpan<int> values) => values[0];
Per i parametri Memory<T>, usare ReadOnlyMemory<T> invece.
Quando eliminare gli avvisi
Eliminare l'avviso solo quando il metodo deve esporre un parametro scrivibile, anche se l'implementazione corrente non modifica i dati.
Eliminare un avviso
Per sopprimere una singola violazione, aggiungere direttive del preprocessore al file di origine per disabilitare e quindi riabilitare la regola.
#pragma warning disable CA1517
// The code that's violating the rule is on this line.
#pragma warning restore CA1517
Per disabilitare la regola per un file, una cartella o un progetto, impostarne la gravità su none nel file di configurazione .
[*.{cs,vb}]
dotnet_diagnostic.CA1517.severity = none
Per altre informazioni, vedere Come eliminare gli avvisi di analisi del codice.