HandleRef Structure

Définition

Espace de noms:

System.Runtime.InteropServices

Assembly:

System.Runtime.InteropServices.dll

Source:

HandleRef.cs

Inclut dans un wrapper un objet managé contenant un handle vers une ressource transmise au code non managé à l’aide de l’appel de code non managé.

public value class HandleRef

public readonly struct HandleRef

type HandleRef = struct

Public Structure HandleRef

Héritage

Object

ValueType

HandleRef

Remarques

Important

À compter de .NET Framework 2.0, les fonctionnalités de la HandleRef classe ont été remplacées par la SafeHandle classe et ses classes dérivées, ainsi que par la CriticalHandle classe .

Si vous utilisez l’appel de plateforme pour appeler un objet managé et que l’objet n’est pas référencé ailleurs après l’appel d’appel de plateforme, il est possible pour le garbage collector de finaliser l’objet managé. Cette action libère la ressource et invalide le handle, ce qui entraîne l’échec de l’appel d’appel de plateforme. Encapsuler un handle avec HandleRef des garanties que l’objet managé n’est pas récupéré par la mémoire tant que l’appel d’appel de plateforme n’est pas terminé. Pour obtenir une description des services d’appel de plateforme, consultez Consommation de fonctions DLL non managées.

Le HandleRef type value, comme GCHandle, est un type spécial reconnu par le marshaleur d’interopérabilité. Un garbage collection normal, non épinglé GCHandle , empêche également le garbage collection intempestive, tout HandleRef en offrant de meilleures performances. Bien qu’il soit préférable d’utiliser HandleRef pour conserver un objet actif pendant la durée d’un appel d’appel de plateforme, vous pouvez également utiliser la GC.KeepAlive méthode dans le même but.

Le HandleRef constructeur prend deux paramètres : un Object représentant le wrapper et un IntPtr représentant le handle non managé. Le marshaleur d’interopérabilité transmet uniquement le handle au code non managé et garantit que le wrapper (passé en tant que premier paramètre au constructeur du HandleRef) reste actif pendant la durée de l’appel.

Constructeurs

HandleRef(Object, IntPtr)

Initialise une nouvelle instance de la classe HandleRef avec l'objet à encapsuler et un handle vers la ressource utilisée par le code non managé.

Propriétés

Handle	Obtient le handle vers une ressource.
Wrapper	Obtient l'objet contenant le handle vers une ressource.

Méthodes

ToIntPtr(HandleRef)

Retourne la représentation interne sous forme d'entier d'un objet HandleRef.

Opérateurs

Explicit(HandleRef to IntPtr)

Retourne le handle vers une ressource de l'objet HandleRef spécifié.

Voir aussi

• SafeHandle
• CriticalHandle