SafeBuffer Classe

Définition

Espace de noms:

System.Runtime.InteropServices

Assembly:

System.Runtime.dll

Fournit une mémoire tampon contrôlée qui peut être utilisée pour la lecture et l'écriture. Toute tentative d'accès à la mémoire en dehors de la mémoire tampon contrôlée (sous-utilisation et dépassement) entraîne la levée d'exceptions.

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

Héritage

Object

CriticalFinalizerObject

SafeHandle

SafeHandleZeroOrMinusOneIsInvalid

SafeBuffer

Dérivé

Microsoft.Win32.SafeHandles.SafeMemoryMappedViewHandle

Remarques

Vous devez appeler la SafeBuffer.Initialize méthode avant d’utiliser une instance de SafeBuffer. Pour éviter les courses lorsque vous stockez une instance d’un SafeBuffer objet dans une variable statique, vous devez utiliser l’une des approches suivantes :

• Créez un verrou lors de la publication de SafeBuffer.

• Créez une variable locale, initialisez le SafeBuffer, puis affectez le SafeBuffer à la variable statique, par exemple, à l’aide de la Interlocked.CompareExchange méthode .

Notes

Les affectations dans un constructeur de classe statique sont implicitement verrouillées.

Constructeurs

SafeBuffer(Boolean)

Crée une instance de la classe SafeBuffer et spécifie si le handle de tampon doit être libéré de manière fiable.

Champs

handle

Spécifie le handle à encapsuler. (Hérité de SafeHandle)

Propriétés

ByteLength	Obtient la taille du tampon, en octets.
IsClosed	Obtient une valeur indiquant si le handle est fermé. (Hérité de SafeHandle)
IsInvalid	Obtient une valeur qui indique si le handle n'est pas valide. (Hérité de SafeHandleZeroOrMinusOneIsInvalid)

Méthodes

AcquirePointer(Byte*)	Obtient un pointeur à partir d'un objet SafeBuffer pour un bloc de mémoire.
Close()	Marque le handle pour libérer des ressources. (Hérité de SafeHandle)
DangerousAddRef(Boolean)	Incrémente manuellement le compteur de références sur les instances de SafeHandle. (Hérité de SafeHandle)
DangerousGetHandle()	Retourne la valeur du champ handle. (Hérité de SafeHandle)
DangerousRelease()	Décrémente manuellement le compteur de références sur une instance de SafeHandle. (Hérité de SafeHandle)
Dispose()	Libère toutes les ressources utilisées par la classe SafeHandle. (Hérité de SafeHandle)
Dispose(Boolean)	Libère les ressources non managées utilisées par la classe SafeHandle, en spécifiant s'il faut exécuter une opération de suppression normale. (Hérité de SafeHandle)
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
Initialize(UInt32, UInt32)	Spécifie la taille d'allocation du tampon de mémoire à l'aide du nombre spécifié d'éléments et de la taille des éléments. Vous devez appeler cette méthode avant d'utiliser l'instance SafeBuffer.
Initialize(UInt64)	Définit la taille d'allocation de la région de mémoire en octets. Vous devez appeler cette méthode avant d'utiliser l'instance SafeBuffer.
Initialize<T>(UInt32)	Définit la taille d'allocation de la région de mémoire en spécifiant le nombre de types valeur. Vous devez appeler cette méthode avant d'utiliser l'instance SafeBuffer.
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
Read<T>(UInt64)	Lit un type valeur dans la mémoire à l'offset spécifié.
ReadArray<T>(UInt64, T[], Int32, Int32)	Lit le nombre spécifié de types valeur dans la mémoire à partir de l'offset indiqué, puis les écrit dans un tableau à partir de l'index indiqué.
ReadSpan<T>(UInt64, Span<T>)	Lit les types de valeurs à partir de la mémoire à partir du décalage et les écrit dans une étendue. Le nombre de types de valeurs à lire est déterminé par la longueur de l’étendue.
ReleaseHandle()	En cas de substitution dans une classe dérivée, exécute le code nécessaire pour libérer le handle. (Hérité de SafeHandle)
ReleasePointer()	Libère un pointeur obtenu par la méthode AcquirePointer(Byte*).
SetHandle(IntPtr)	Définit le handle au handle préexistant spécifié. (Hérité de SafeHandle)
SetHandleAsInvalid()	Marque un handle comme n'étant plus utilisé. (Hérité de SafeHandle)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)
Write<T>(UInt64, T)	Écrit un type valeur dans la mémoire à l'emplacement donné.
WriteArray<T>(UInt64, T[], Int32, Int32)	Écrit le nombre spécifié de types valeur dans un emplacement de mémoire en lisant les octets qui commencent à partir de l'emplacement spécifié dans le tableau d'entrée.
WriteSpan<T>(UInt64, ReadOnlySpan<T>)	Écrit les types de valeur d’une étendue en lecture seule dans un emplacement mémoire.