CA1844 : fournissez des remplacements basés sur la mémoire des méthodes asynchrones lors du sous-classement de « Stream »

  • Article
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é par défaut dans .NET 8 Comme 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 ValueTask et ValueTask<int> au lieu de Task et Task<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 Stream n’utilisera jamais que des méthodes de type tableau.
  • Votre sous-classe Stream possè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.

Voir aussi