CKTIS / C#
IMemoryOwner<T> — propiedad de un búfer de memoria
IMemoryOwner<T> expresa la responsabilidad sobre la vida útil de un búfer. Su propiedad Memory expone el contenido como Memory<T>, mientras que Dispose, heredado, pone fin al uso del recurso por parte de su propietario.
Versión: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaxis
public interface IMemoryOwner<T> : IDisposable
{
Memory<T> Memory { get; }
}IMemoryOwner<T> en el espacio de nombres System.Buffers representa al propietario de un búfer de elementos de tipo T. Está disponible en .NET 10. Un búfer tiene un solo propietario a la vez, aunque puede tener varios consumidores. La propiedad implica responsabilidad sobre la vida útil del recurso, no acceso exclusivo a sus datos.
La propiedad IMemoryOwner<T>.Memory es de tipo Memory<T> y solo tiene un descriptor de acceso get. Sin embargo, esto no hace que los elementos sean inmutables: se pueden modificar a través de owner.Memory.Span. Pasar una vista Memory<T> a otro código no transfiere por sí solo la propiedad ni prolonga la vida útil del búfer.
La interfaz hereda IDisposable.Dispose. Llama a Dispose() solo cuando hayan terminado todos los consumidores, incluidas las operaciones asíncronas; después, no uses el búfer ni las vistas conservadas. Una implementación puede, por ejemplo, devolver la memoria a un pool de memoria. Tras transferir la propiedad, el propietario anterior no debería usar ni liberar el búfer; esa responsabilidad corresponde al nuevo propietario.
El ejemplo usa MemoryPool<int>.Shared.Rent(3), que proporciona al menos tres elementos, no necesariamente exactamente tres. Slice(0, 3) selecciona la parte utilizada, y el código escribe todos los elementos que lee. El bloque using llama a Dispose() incluso si se produce una excepción. La salida esperada es 60.
Ejemplos
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]);
}
}
}Resultado
60
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.