CA1844 : fournissez des remplacements basés sur la mémoire des méthodes asynchrones lors du sous-classement de « Stream »
| Propriété | Value |
|---|---|
| Identificateur de la règle | CA1844 |
| Titre | Fournir des remplacements basés sur la mémoire des méthodes async lors du sous-classement de 'Stream' |
| Catégorie | Performances |
| Le correctif est cassant ou non cassant | Sans rupture |
| Activée par défaut dans .NET 9 | À titre de suggestion |
Cause
Un type dérivé de Stream remplace ReadAsync(Byte[], Int32, Int32, CancellationToken), mais ne remplace pas ReadAsync(Memory<Byte>, CancellationToken). De même, un type dérivé de Stream remplace WriteAsync(Byte[], Int32, Int32, CancellationToken), mais ne remplace pas WriteAsync(ReadOnlyMemory<Byte>, CancellationToken).
Description de la règle
Les méthodes ReadAsync et WriteAsync basées sur la mémoire ont été ajoutées pour améliorer les performances, ce qu’elles effectuent de plusieurs façons :
- Elles retournent respectivement
ValueTasketValueTask<int>au lieu deTasketTask<int>. - Elles permettent de passer n’importe quel type de mémoire tampon sans avoir à effectuer une copie supplémentaire dans un tableau.
Ces avantages en matière de performances sont possibles si les types qui dérivent de Stream fournissent leur propre implémentation basée sur la mémoire. Dans le cas contraire, l’implémentation par défaut est forcée de copier la mémoire dans un tableau pour pouvoir appeler l’implémentation de type tableau, ce qui réduit les performances. Lorsque l’appelant transmet une instance de Memory<T> ou de ReadOnlyMemory<T> qui ne s’appuie pas sur un tableau, l’effet sur les performances est accru.
Comment corriger les violations
Le moyen le plus simple de corriger les violations consiste à réécrire l’implémentation de type tableau comme une implémentation basée sur la mémoire, puis à implémenter les méthodes de type tableau sous forme de méthodes basées sur la mémoire.
Quand supprimer les avertissements
Vous pouvez sans risque supprimer un avertissement de cette règle dans chacune des situations suivantes :
- L’impact sur les performances ne constitue pas un problème.
- Vous savez que votre sous-classe
Streamn’utilisera jamais que des méthodes de type tableau. - Votre sous-classe
Streampossède des dépendances qui ne prennent pas en charge les mémoires tampons basées sur la mémoire.
Supprimer un avertissement
Si vous voulez supprimer une seule violation, ajoutez des directives de préprocesseur à votre fichier source pour désactiver et réactiver la règle.
#pragma warning disable CA1844
// The code that's violating the rule is on this line.
#pragma warning restore CA1844
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.CA1844.severity = none
Pour plus d’informations, consultez Comment supprimer les avertissements de l’analyse de code.
