Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
CA1517 : Utiliser
| 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.