SafeBuffer Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Attention
SafeBuffer may be unavailable in future releases.
Fournit une mémoire tampon contrôlée qui peut être utilisée pour la lecture et l’écriture. Les tentatives d’accès à la mémoire en dehors de la mémoire tampon contrôlée (dépassements et dépassements) déclenchent des exceptions.
public ref class SafeBuffer abstract : System::Runtime::InteropServices::SafeHandlepublic ref class SafeBuffer abstract : Microsoft::Win32::SafeHandles::SafeHandleZeroOrMinusOneIsInvalid[System.Security.SecurityCritical]
public abstract class SafeBuffer : System.Runtime.InteropServices.SafeHandle[System.Security.SecurityCritical]
public abstract class SafeBuffer : Microsoft.Win32.SafeHandles.SafeHandleZeroOrMinusOneIsInvalid[System.Security.SecurityCritical]
[System.Obsolete("SafeBuffer may be unavailable in future releases.")]
public abstract class SafeBuffer : System.Runtime.InteropServices.SafeHandlepublic abstract class SafeBuffer : Microsoft.Win32.SafeHandles.SafeHandleZeroOrMinusOneIsInvalid[<System.Security.SecurityCritical>]
type SafeBuffer = class
inherit SafeHandle[<System.Security.SecurityCritical>]
type SafeBuffer = class
inherit SafeHandleZeroOrMinusOneIsInvalid[<System.Security.SecurityCritical>]
[<System.Obsolete("SafeBuffer may be unavailable in future releases.")>]
type SafeBuffer = class
inherit SafeHandletype SafeBuffer = class
inherit SafeHandleZeroOrMinusOneIsInvalidPublic MustInherit Class SafeBuffer
Inherits SafeHandlePublic MustInherit Class SafeBuffer
Inherits SafeHandleZeroOrMinusOneIsInvalid- Héritage
- Héritage
- Dérivé
- Attributs
Remarques
Vous devez appeler la SafeBuffer.Initialize méthode avant d’utiliser n’importe quelle 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 du SafeBuffer.
Créez une variable locale, initialisez le SafeBuffer, puis affectez-la SafeBuffer à la variable statique, par exemple, à l’aide de la Interlocked.CompareExchange méthode.
Note
Les affectations dans un constructeur de classe statique sont implicitement verrouillées.
Constructeurs
| Nom | Description |
|---|---|
| SafeBuffer(Boolean) |
Obsolète.
Crée une instance de la SafeBuffer classe et spécifie si le handle de mémoire tampon doit être libéré de manière fiable. |
Champs
| Nom | Description |
|---|---|
| handle |
Obsolète.
Spécifie le handle à wrapper. (Hérité de SafeHandle) |
Propriétés
| Nom | Description |
|---|---|
| ByteLength |
Obsolète.
Obtient la taille de la mémoire tampon, en octets. |
| IsClosed |
Obsolète.
Obtient une valeur indiquant si le handle est fermé. (Hérité de SafeHandle) |
| IsInvalid |
Obsolète.
Obtient une valeur qui indique si le handle n’est pas valide. |
| IsInvalid |
Obsolète.
Obtient une valeur qui indique si le handle n’est pas valide. (Hérité de SafeHandleZeroOrMinusOneIsInvalid) |
Méthodes
| Nom | Description |
|---|---|
| AcquirePointer(Byte*) |
Obsolète.
Obtient un pointeur à partir d’un SafeBuffer objet pour un bloc de mémoire. |
| Close() |
Obsolète.
Marque le handle pour libérer et libérer des ressources. (Hérité de SafeHandle) |
| DangerousAddRef(Boolean) |
Obsolète.
Incrémente manuellement le compteur de référence sur SafeHandle les instances. (Hérité de SafeHandle) |
| DangerousGetHandle() |
Obsolète.
Retourne la valeur du handle champ. (Hérité de SafeHandle) |
| DangerousRelease() |
Obsolète.
Décrémente manuellement le compteur de référence sur une SafeHandle instance. (Hérité de SafeHandle) |
| Dispose() |
Obsolète.
Libère toutes les ressources utilisées par la SafeHandle classe. (Hérité de SafeHandle) |
| Dispose(Boolean) |
Obsolète.
Libère les ressources non managées utilisées par la SafeHandle classe spécifiant s’il faut effectuer une opération de suppression normale. (Hérité de SafeHandle) |
| Equals(Object) |
Obsolète.
Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object) |
| GetHashCode() |
Obsolète.
Sert de fonction de hachage par défaut. (Hérité de Object) |
| GetType() |
Obsolète.
Obtient la Type de l’instance actuelle. (Hérité de Object) |
| Initialize(UInt32, UInt32) |
Obsolète.
Spécifie la taille d’allocation de la mémoire tampon à l’aide du nombre spécifié d’éléments et de taille d’élément. Vous devez appeler cette méthode avant d’utiliser l’instance SafeBuffer . |
| Initialize(UInt64) |
Obsolète.
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) |
Obsolète.
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() |
Obsolète.
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| Read<T>(UInt64) |
Obsolète.
Lit un type valeur à partir de la mémoire au décalage spécifié. |
| ReadArray<T>(UInt64, T[], Int32, Int32) |
Obsolète.
Lit le nombre spécifié de types valeur à partir de la mémoire à partir du décalage et les écrit dans un tableau commençant à l’index. |
| ReleaseHandle() |
Obsolète.
En cas de substitution dans une classe dérivée, exécute le code requis pour libérer le handle. (Hérité de SafeHandle) |
| ReleasePointer() |
Obsolète.
Libère un pointeur obtenu par la AcquirePointer(Byte*) méthode. |
| SetHandle(IntPtr) |
Obsolète.
Définit le handle sur le handle pré-existant spécifié. (Hérité de SafeHandle) |
| SetHandleAsInvalid() |
Obsolète.
Marque un handle comme n’étant plus utilisé. (Hérité de SafeHandle) |
| ToString() |
Obsolète.
Retourne une chaîne qui représente l’objet actuel. (Hérité de Object) |
| Write<T>(UInt64, T) |
Obsolète.
Écrit un type valeur en mémoire à l’emplacement donné. |
| WriteArray<T>(UInt64, T[], Int32, Int32) |
Obsolète.
Écrit le nombre spécifié de types valeur dans un emplacement mémoire en lisant les octets à partir de l’emplacement spécifié dans le tableau d’entrée. |