CKTIS / C#
IMemoryOwner<T> — propriété d’un tampon mémoire
IMemoryOwner<T> exprime la responsabilité liée à la durée de vie d’un tampon. Sa propriété Memory expose le contenu sous forme de Memory<T>, tandis que Dispose, hérité de l’interface de base, met fin à l’utilisation de la ressource par son propriétaire.
Version : .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntaxe
public interface IMemoryOwner<T> : IDisposable
{
Memory<T> Memory { get; }
}IMemoryOwner<T> dans l’espace de noms System.Buffers représente le propriétaire d’un tampon contenant des éléments de type T. Cette interface est disponible dans .NET 10. Un tampon n’a qu’un propriétaire à la fois, mais peut avoir plusieurs utilisateurs. La propriété signifie que l’on est responsable de la durée de vie de la ressource, et non que l’on dispose d’un accès exclusif à ses données.
La propriété IMemoryOwner<T>.Memory est de type Memory<T> et ne possède qu’un accesseur get. Cela ne rend pas les éléments immuables : ils peuvent être modifiés via owner.Memory.Span. Transmettre une vue Memory<T> à un autre code ne transfère pas, à lui seul, la propriété et ne prolonge pas la durée de vie du tampon.
L’interface hérite de IDisposable.Dispose. Appelez Dispose() seulement lorsque tous les utilisateurs, y compris les opérations asynchrones, ont terminé ; ensuite, n’utilisez plus le tampon ni les vues conservées. Une implémentation peut, par exemple, rendre la mémoire à un pool. Après avoir transféré la propriété, l’ancien propriétaire ne doit ni utiliser ni libérer le tampon ; cette responsabilité revient au nouveau propriétaire.
L’exemple utilise MemoryPool<int>.Shared.Rent(3), qui fournit au moins trois éléments, pas nécessairement exactement trois. Slice(0, 3) sélectionne la partie utilisée, et le code écrit chaque élément qu’il lit. Le bloc using appelle Dispose() même si une exception se produit. La sortie attendue est 60.
Exemples
using System;
using System.Buffers;
internal static class Program
{
private static void Main()
{
using (IMemoryOwner<int> owner = MemoryPool<int>.Shared.Rent(3))
{
Memory<int> memory = owner.Memory.Slice(0, 3);
Span<int> span = memory.Span;
span[0] = 10;
span[1] = 20;
span[2] = 30;
Console.WriteLine(span[0] + span[1] + span[2]);
}
}
}Résultat
60
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.