SafeHandle.IsInvalid Propriété

Définition

En cas de substitution dans une classe dérivée, obtient une valeur indiquant si la valeur du handle n'est pas valide.

public:
 abstract property bool IsInvalid { bool get(); };
public abstract bool IsInvalid { get; }
member this.IsInvalid : bool
Public MustOverride ReadOnly Property IsInvalid As Boolean

Valeur de propriété

true si la valeur du handle n'est pas valide, sinon false.

Exemples

L’exemple suivant vérifie si un fichier a été correctement ouvert. Cet exemple de code fait partie d’un exemple plus grand fourni pour la SafeHandle classe .

// Determine if file is opened successfully.
if (_handle.IsInvalid)
    throw new Win32Exception(Marshal.GetLastWin32Error(), fileName);

Remarques

Les classes dérivées doivent implémenter la IsInvalid propriété afin que le Common Language Runtime puisse déterminer si la finalisation critique est requise. Les classes dérivées doivent fournir une implémentation qui convient au type général de handle qu’elles prennent en charge (0 ou -1 n’est pas valide). Ces classes peuvent ensuite être dérivées pour des types de handle sécurisés spécifiques.

Contrairement à la IsClosed propriété , qui indique si l’objet SafeHandle a terminé d’utiliser le handle sous-jacent, la IsInvalid propriété calcule si la valeur de handle donnée est toujours considérée comme non valide. Par conséquent, la IsInvalid propriété retourne toujours la même valeur pour une valeur de handle.

S’applique à