SafeBuffer Třída

Definice

Obor názvů:

System.Runtime.InteropServices

Sestavení:

System.Runtime.dll

Zdroj:

SafeBuffer.cs

Poskytuje řízenou vyrovnávací paměť, která se dá použít pro čtení a zápis. Pokusy o přístup k paměti mimo řízenou vyrovnávací paměť (podběh a přetečení) vyvolávají výjimky.

public ref class SafeBuffer abstract : Microsoft::Win32::SafeHandles::SafeHandleZeroOrMinusOneIsInvalid

public abstract class SafeBuffer : Microsoft.Win32.SafeHandles.SafeHandleZeroOrMinusOneIsInvalid

type SafeBuffer = class
    inherit SafeHandleZeroOrMinusOneIsInvalid

Public MustInherit Class SafeBuffer
Inherits SafeHandleZeroOrMinusOneIsInvalid

Dědičnost

Object

CriticalFinalizerObject

SafeHandle

SafeHandleZeroOrMinusOneIsInvalid

SafeBuffer

Odvozené

Microsoft.Win32.SafeHandles.SafeMemoryMappedViewHandle

Poznámky

Před použitím jakékoli instance je nutné volat SafeBuffer.Initialize metodu SafeBuffer. Pokud se chcete vyhnout rasám při ukládání instance objektu SafeBuffer do statické proměnné, měli byste použít jeden z následujících přístupů:

• Create zámek při publikování souboru SafeBuffer.

• Create místní proměnnou, inicializujte SafeBuffera pak přiřaďte SafeBuffer proměnnou statickou, například pomocí Interlocked.CompareExchange metody .

Poznámka

Přiřazení v konstruktoru statické třídy jsou implicitně uzamčena.

Konstruktory

SafeBuffer(Boolean)

Vytvoří novou instanci SafeBuffer třídy a určuje, zda má být spolehlivě uvolněn popisovač vyrovnávací paměti.

Pole

handle

Určuje popisovač, který se má zabalit. (Zděděno od SafeHandle)

Vlastnosti

ByteLength	Získá velikost vyrovnávací paměti v bajtech.
IsClosed	Získá hodnotu označující, zda je popisovač uzavřen. (Zděděno od SafeHandle)
IsInvalid	Získá hodnotu, která označuje, zda popisovač je neplatný. (Zděděno od SafeHandleZeroOrMinusOneIsInvalid)

Metody

AcquirePointer(Byte*)	Získá ukazatel z objektu SafeBuffer pro blok paměti.
Close()	Označí popisovač pro uvolnění a uvolnění prostředků. (Zděděno od SafeHandle)
DangerousAddRef(Boolean)	Ručně zvýší čítač odkazů na SafeHandle instance. (Zděděno od SafeHandle)
DangerousGetHandle()	Vrátí hodnotu handle pole. (Zděděno od SafeHandle)
DangerousRelease()	Ručně sníží čítač odkazů na SafeHandle instanci. (Zděděno od SafeHandle)
Dispose()	Uvolní všechny prostředky používané SafeHandle třídou. (Zděděno od SafeHandle)
Dispose(Boolean)	Uvolní nespravované prostředky používané SafeHandle třídou určující, zda se má provést normální operace dispose. (Zděděno od SafeHandle)
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
Initialize(UInt32, UInt32)	Určuje velikost přidělení vyrovnávací paměti pomocí zadaného počtu prvků a velikosti elementů. Před použitím instance je nutné volat tuto metodu SafeBuffer .
Initialize(UInt64)	Definuje velikost přidělení oblasti paměti v bajtech. Před použitím instance je nutné volat tuto metodu SafeBuffer .
Initialize<T>(UInt32)	Definuje velikost přidělení oblasti paměti zadáním počtu typů hodnot. Před použitím instance je nutné volat tuto metodu SafeBuffer .
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
Read<T>(UInt64)	Načte typ hodnoty z paměti při zadaném posunu.
ReadArray<T>(UInt64, T[], Int32, Int32)	Přečte zadaný počet hodnotových typů z paměti od posunu a zapíše je do pole počínaje indexem.
ReadSpan<T>(UInt64, Span<T>)	Čte typy hodnot z paměti od posunu a zapisuje je do rozsahu. Počet typů hodnot, které se budou číst, je určen délkou rozsahu.
ReleaseHandle()	Při přepsání v odvozené třídě spustí kód potřebný k uvolnění popisovače. (Zděděno od SafeHandle)
ReleasePointer()	Uvolní ukazatel, který byl získán metodou AcquirePointer(Byte*) .
SetHandle(IntPtr)	Nastaví popisovač na zadaný již existující popisovač. (Zděděno od SafeHandle)
SetHandleAsInvalid()	Označí úchyt jako nepoužívaný. (Zděděno od SafeHandle)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
Write<T>(UInt64, T)	Zapíše typ hodnoty do paměti v daném umístění.
WriteArray<T>(UInt64, T[], Int32, Int32)	Zapíše zadaný počet typů hodnot do umístění v paměti čtením bajtů od zadaného umístění ve vstupním poli.
WriteSpan<T>(UInt64, ReadOnlySpan<T>)	Zapíše typy hodnot z rozsahu jen pro čtení do umístění paměti.