CKTIS / C#
IMemoryOwner<T> — propriedade de um buffer de memória
IMemoryOwner<T> exprime a responsabilidade pelo tempo de vida de um buffer. A propriedade Memory expõe o respetivo conteúdo como Memory<T>, enquanto Dispose, herdado, termina a utilização do recurso pelo proprietário.
Versão: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaxe
public interface IMemoryOwner<T> : IDisposable
{
Memory<T> Memory { get; }
}IMemoryOwner<T> no espaço de nomes System.Buffers representa o proprietário de um buffer de elementos do tipo T. Está disponível no .NET 10. Um buffer tem um único proprietário de cada vez, embora possa ter vários utilizadores. A propriedade significa responsabilidade pelo tempo de vida do recurso, não acesso exclusivo aos seus dados.
A propriedade IMemoryOwner<T>.Memory é do tipo Memory<T> e tem apenas um acessor get. No entanto, isso não torna os elementos imutáveis: podem ser alterados através de owner.Memory.Span. Passar uma vista Memory<T> a outro código não transfere, por si só, a propriedade nem prolonga o tempo de vida do buffer.
A interface herda IDisposable.Dispose. Chame Dispose() apenas depois de todos os utilizadores, incluindo operações assíncronas, terem terminado; depois disso, não utilize o buffer nem as vistas guardadas. Uma implementação pode, por exemplo, devolver a memória a um pool de memória. Depois de transferir a propriedade, o proprietário anterior não deve utilizar nem libertar o buffer; essa responsabilidade cabe ao novo proprietário.
O exemplo utiliza MemoryPool<int>.Shared.Rent(3), que fornece pelo menos três elementos, não necessariamente exatamente três. Slice(0, 3) seleciona a parte utilizada, e o código escreve todos os elementos que lê. O bloco using chama Dispose() mesmo que ocorra uma exceção. O resultado esperado é 60.
Exemplos
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
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.