SafeBuffer Třída

Definice

Obor názvů:

System.Runtime.InteropServices

Sestavení:

System.Runtime.dll

Source:

SafeBuffer.cs

Poskytuje řízenou vyrovnávací paměť, kterou lze 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ů:

• Při publikování SafeBuffervytvořte zámek .

• Vytvořte místní proměnnou, inicializujte SafeBuffera pak přiřaďte SafeBuffer statickou proměnnou , 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 popisovač vyrovnávací paměti spolehlivě uvolněn.

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 je popisovač 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 odstranění. (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()	Type Získá z aktuální instance. (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ů. Tuto metodu je nutné volat před použitím SafeBuffer instance.
Initialize(UInt64)	Definuje velikost přidělení oblasti paměti v bajtech. Tuto metodu je nutné volat před použitím SafeBuffer instance.
Initialize<T>(UInt32)	Definuje velikost přidělení oblasti paměti zadáním počtu typů hodnot. Tuto metodu je nutné volat před použitím SafeBuffer instance.
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)	Načte zadaný počet typů hodnot z paměti počínaje posunem a zapíše je do pole počínaje indexem.
ReadSpan<T>(UInt64, Span<T>)	Čte typy hodnot z paměti počínaje posunem 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ý předem existující popisovač. (Zděděno od SafeHandle)
SetHandleAsInvalid()	Označí úchyt jako již 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ů počínaje zadaným umístěním ve vstupním poli.
WriteSpan<T>(UInt64, ReadOnlySpan<T>)	Zapíše typy hodnot z rozsahu jen pro čtení do umístění v paměti.