CKTIS / C#
IMemoryOwner<T> — собственост върху буфер в паметта
IMemoryOwner<T> изразява отговорността за жизнения цикъл на буфера. Свойството Memory предоставя съдържанието му като Memory<T>, а наследеният Dispose прекратява използването на ресурса от собственика.
Версия: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Синтаксис
public interface IMemoryOwner<T> : IDisposable
{
Memory<T> Memory { get; }
}IMemoryOwner<T> в пространството от имена System.Buffers представлява собственика на буфер с елементи от тип T. Налично е в .NET 10. В даден момент буферът има един собственик, но може да има много потребители. Собствеността означава отговорност за жизнения цикъл на ресурса, а не изключителен достъп до данните му.
Свойството IMemoryOwner<T>.Memory е от тип Memory<T> и има само аксесор get. Това обаче не прави елементите неизменяеми: те могат да се променят чрез owner.Memory.Span. Предаването на изглед Memory<T> на друг код само по себе си не прехвърля собствеността и не удължава жизнения цикъл на буфера.
Интерфейсът наследява IDisposable.Dispose. Извикайте Dispose() едва след като всички потребители, включително асинхронните операции, приключат; след това не използвайте буфера или запазените изгледи. Реализацията може например да върне паметта в пул. След прехвърляне на собствеността предишният собственик не бива да използва или освобождава буфера; за това отговаря новият собственик.
Примерът използва MemoryPool<int>.Shared.Rent(3), което предоставя поне три елемента, но не непременно точно три. Slice(0, 3) избира използваната част, а кодът записва всеки елемент, който прочита. Блокът using извиква Dispose() дори ако възникне изключение. Очакваният изход е 60.
Примери
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]);
}
}
}Резултат
60
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.