Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C#

IMemoryOwner<T> — vlasništvo nad memorijskim međuspremnikom

IMemoryOwner<T> izražava odgovornost za životni vijek međuspremnika. Svojstvo Memory izlaže njegov sadržaj kao Memory<T>, dok naslijeđeni Dispose završava vlasnikovo korištenje resursa.

Verzija: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Sintaksa

public interface IMemoryOwner<T> : IDisposable
{
    Memory<T> Memory { get; }
}

IMemoryOwner<T> u prostoru naziva System.Buffers predstavlja vlasnika međuspremnika s elementima tipa T. Dostupan je u .NET 10. Međuspremnik u određenom trenutku ima jednog vlasnika, ali može imati više korisnika. Vlasništvo znači odgovornost za životni vijek resursa, a ne isključiv pristup njegovim podacima.

Svojstvo IMemoryOwner<T>.Memory tipa je Memory<T> i ima samo pristupnik get. To ipak ne čini elemente nepromjenjivima: mogu se mijenjati putem owner.Memory.Span. Prosljeđivanje prikaza Memory<T> drugom kodu samo po sebi ne prenosi vlasništvo niti produljuje životni vijek međuspremnika.

Sučelje nasljeđuje IDisposable.Dispose. Pozovite Dispose() tek kada svi korisnici, uključujući asinkrone operacije, završe; nakon toga nemojte koristiti međuspremnik ni spremljene prikaze. Implementacija može, primjerice, vratiti memoriju u memorijski bazen. Nakon prijenosa vlasništva prethodni vlasnik ne bi trebao koristiti ni osloboditi međuspremnik; za to je odgovoran novi vlasnik.

Primjer koristi MemoryPool<int>.Shared.Rent(3), koji osigurava najmanje tri elementa, ne nužno točno tri. Slice(0, 3) odabire dio koji se koristi, a kod zapisuje svaki element koji čita. Blok using poziva Dispose() čak i ako dođe do iznimke. Očekivani izlaz je 60.

Primjeri

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]);
        }
    }
}

Rezultat

60

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori