База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници