KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C#

IMemoryOwner<T> — eigenaarschap van een geheugenbuffer

IMemoryOwner<T> drukt de verantwoordelijkheid voor de levensduur van een buffer uit. De eigenschap Memory stelt de inhoud beschikbaar als Memory<T>; de overgeërfde Dispose beëindigt het gebruik van de resource door de eigenaar.

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

Syntax

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

IMemoryOwner<T> in de naamruimte System.Buffers vertegenwoordigt de eigenaar van een buffer met elementen van het type T. De interface is beschikbaar in .NET 10. Een buffer heeft op elk moment één eigenaar, maar kan meerdere gebruikers hebben. Eigenaarschap betekent verantwoordelijkheid voor de levensduur van de resource, niet exclusieve toegang tot de gegevens.

De eigenschap IMemoryOwner<T>.Memory heeft het type Memory<T> en alleen een get-accessor. Dat maakt de elementen echter niet onveranderlijk: ze kunnen via owner.Memory.Span worden gewijzigd. Een Memory<T>-weergave aan andere code doorgeven, draagt op zichzelf het eigenaarschap niet over en verlengt de levensduur van de buffer niet.

De interface erft IDisposable.Dispose. Roep Dispose() pas aan wanneer alle gebruikers, inclusief asynchrone bewerkingen, klaar zijn; gebruik daarna de buffer en bewaarde weergaven niet meer. Een implementatie kan het geheugen bijvoorbeeld teruggeven aan een pool. Na overdracht van het eigenaarschap hoort de vorige eigenaar de buffer niet meer te gebruiken of vrij te geven; die verantwoordelijkheid ligt bij de nieuwe eigenaar.

Het voorbeeld gebruikt MemoryPool<int>.Shared.Rent(3), dat ten minste drie elementen levert, niet noodzakelijk precies drie. Slice(0, 3) selecteert het gebruikte deel, en de code schrijft elk element dat wordt gelezen. Het using-blok roept Dispose() ook aan als er een uitzondering optreedt. De verwachte uitvoer is 60.

Voorbeelden

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

Resultaat

60

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen