CA1517 : Utiliser ReadOnlySpan<T> ou Span<T> au lieu de ReadOnlyMemory<T> ou Memory<T>

Propriété Value
ID de règle CA1517
Titre Utiliser ReadOnlySpan<T> ou ReadOnlyMemory<T> non Span<T> ou Memory<T>
Catégorie Facilité de maintenance
Le correctif a un effet disruptif ou non disruptif Non-breaking
Activé par défaut dans .NET 10 No
Activé par défaut dans .NET 11 Comme suggestion
Langues applicables C#

Cause

Une méthode a un paramètre Memory<T> ou Span<T> qu’elle ne modifie pas.

Description de la règle

Utilisez ReadOnlySpan<T> ou ReadOnlyMemory<T> pour les données qu’une méthode lit uniquement. Le type en lecture seule clarifie l’intention de la méthode et permet aux appelants de transmettre des données qu’ils ne peuvent pas modifier.

Comment corriger les violations

Remplacez le type de paramètre par son équivalent en lecture seule. L’analyseur ne signale pas les méthodes dont le type de paramètre ne peut pas être modifié en toute sécurité, comme les méthodes virtuelles ou d’interface.

Examples

Le code suivant montre une violation de CA1517 :

static int GetFirst(Span<int> values) => values[0];

Remplacez Span<T> par ReadOnlySpan<T> :

static int GetFirst(ReadOnlySpan<int> values) => values[0];

Pour les Memory<T> paramètres, utilisez ReadOnlyMemory<T> à la place.

Quand supprimer les avertissements

Supprimez l’avertissement uniquement lorsque la méthode doit exposer un paramètre accessible en écriture, même si son implémentation actuelle ne modifie pas les données.

Supprimer un avertissement

Pour supprimer une seule violation, ajoutez des directives de préprocesseur à votre fichier source pour désactiver, puis réactivez la règle.

#pragma warning disable CA1517
// The code that's violating the rule is on this line.
#pragma warning restore CA1517

Pour désactiver la règle sur un fichier, un dossier ou un projet, définissez sa gravité sur none dans le fichier de configuration.

[*.{cs,vb}]
dotnet_diagnostic.CA1517.severity = none

Pour plus d’informations, consultez Comment supprimer les avertissements d’analyse du code.

Voir aussi