Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes