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.When overridden in a derived class, gets a value indicating whether the handle value is invalid.

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.true if the handle value is invalid; otherwise, false.

Exemples

L’exemple suivant vérifie si un fichier a été ouvert avec succès.The following example checks if a file was opened successfully. Cet exemple de code fait partie d’un exemple plus complet fourni pour la classe SafeHandle.This code example is part of a larger example provided for the SafeHandle class.

// 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 propriété IsInvalid afin que le common language runtime puisse déterminer si la finalisation critique est requise.Derived classes must implement the IsInvalid property so that the common language runtime can determine whether critical finalization is required. Les classes dérivées doivent fournir une implémentation qui correspond au type général de handle qu’elles prennent en charge (0 ou-1 n’est pas valide).Derived classes must provide an implementation that suits the general type of handle they support (0 or -1 is invalid). Ces classes peuvent ensuite être dérivées davantage pour des types de Handles sécurisés spécifiques.These classes can then be further derived for specific safe handle types.

Contrairement à la propriété IsClosed, qui indique si l’objet SafeHandle a fini d’utiliser le handle sous-jacent, la propriété IsInvalid calcule si la valeur de handle donnée est toujours considérée comme non valide.Unlike the IsClosed property, which reports whether the SafeHandle object has finished using the underlying handle, the IsInvalid property calculates whether the given handle value is always considered invalid. Par conséquent, la propriété IsInvalid retourne toujours la même valeur pour une valeur de handle quelconque.Therefore, the IsInvalid property always returns the same value for any one handle value.

Sécurité

SecurityPermission
pour obtenir l’autorisation d’appeler du code non managé.for permission to call unmanaged code. Action de sécurité : LinkDemand.Security action: LinkDemand. Énumération associée : UnmanagedCodeAssociated enumeration: UnmanagedCode

S’applique à