CA1517: Usare ReadOnlySpan<T> o ReadOnlyMemory<T> invece di Span<T> o Memory<T>

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.

Vedere anche