WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C#

IMemoryOwner<T> — Eigentümerschaft an einem Speicherpuffer

IMemoryOwner<T> beschreibt die Verantwortung für die Lebensdauer eines Puffers. Die Eigenschaft Memory stellt dessen Inhalt als Memory<T> bereit; das geerbte Dispose beendet die Nutzung der Ressource durch den Eigentümer.

Version: .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> im Namespace System.Buffers steht für den Eigentümer eines Puffers mit Elementen des Typs T. Die Schnittstelle ist in .NET 10 verfügbar. Ein Puffer hat jeweils einen Eigentümer, kann aber von mehreren Verbrauchern genutzt werden. Eigentümerschaft bedeutet Verantwortung für die Lebensdauer der Ressource, nicht exklusiven Zugriff auf ihre Daten.

Die Eigenschaft IMemoryOwner<T>.Memory hat den Typ Memory<T> und nur einen get-Accessor. Das macht die Elemente jedoch nicht unveränderlich: Sie können über owner.Memory.Span geändert werden. Das Weitergeben einer Memory<T>-Ansicht an anderen Code überträgt für sich genommen weder die Eigentümerschaft noch verlängert es die Lebensdauer des Puffers.

Die Schnittstelle erbt IDisposable.Dispose. Rufe Dispose() erst auf, wenn alle Verbraucher, einschließlich asynchroner Vorgänge, fertig sind; verwende danach weder den Puffer noch gespeicherte Ansichten. Eine Implementierung kann den Speicher beispielsweise an einen Pool zurückgeben. Nach der Übertragung der Eigentümerschaft sollte der vorherige Eigentümer den Puffer weder verwenden noch freigeben; dafür ist der neue Eigentümer verantwortlich.

Das Beispiel verwendet MemoryPool<int>.Shared.Rent(3), das mindestens drei Elemente bereitstellt, aber nicht unbedingt genau drei. Slice(0, 3) wählt den verwendeten Abschnitt aus, und der Code schreibt jedes Element, das er liest. Der using-Block ruft Dispose() auch dann auf, wenn eine Ausnahme auftritt. Die erwartete Ausgabe ist 60.

Beispiele

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

Ergebnis

60

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen