Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C#

IMemoryOwner<T> — lastništvo pomnilniškega medpomnilnika

IMemoryOwner<T> izraža odgovornost za življenjsko dobo medpomnilnika. Lastnost Memory izpostavi njegovo vsebino kot Memory<T>, podedovani Dispose pa konča uporabo vira s strani lastnika.

Različica: .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> v imenskem prostoru System.Buffers predstavlja lastnika medpomnilnika z elementi tipa T. Na voljo je v .NET 10. Medpomnilnik ima lahko v danem trenutku enega lastnika, uporablja pa ga lahko več uporabnikov. Lastništvo pomeni odgovornost za življenjsko dobo vira, ne pa izključnega dostopa do njegovih podatkov.

Lastnost IMemoryOwner<T>.Memory je tipa Memory<T> in ima samo dostopnik get. To pa ne pomeni, da so elementi nespremenljivi: spreminjati jih je mogoče prek owner.Memory.Span. Če drugemu delu kode posredujete pogled Memory<T>, s tem sami po sebi ne prenesete lastništva in ne podaljšate življenjske dobe medpomnilnika.

Vmesnik podeduje IDisposable.Dispose. Dispose() pokličite šele, ko končajo vsi uporabniki, vključno z asinhronimi operacijami; nato medpomnilnika ali shranjenih pogledov ne uporabljajte več. Implementacija lahko na primer pomnilnik vrne v zbirko. Po prenosu lastništva prejšnji lastnik medpomnilnika ne bi smel več uporabljati ali sprostiti; za to je odgovoren novi lastnik.

Primer uporablja MemoryPool<int>.Shared.Rent(3), ki zagotovi vsaj tri elemente, ne nujno natanko tri. Slice(0, 3) izbere uporabljeni del, koda pa zapiše vsak element, ki ga prebere. Blok using pokliče Dispose() tudi ob izjemi. Pričakovani izpis je 60.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri