SafeHandle.IsInvalid Propriété
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.
En cas de substitution dans une classe dérivée, obtient une valeur indiquant si la valeur de handle n’est pas valide.
public:
abstract property bool IsInvalid { bool get(); };public abstract bool IsInvalid { get; }member this.IsInvalid : boolPublic MustOverride ReadOnly Property IsInvalid As BooleanValeur de propriété
true si la valeur de handle n’est pas valide ; sinon, false.
Exemples
L’exemple suivant vérifie si un fichier a été ouvert correctement. 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’ils 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é spécifiques.
Contrairement à la IsClosed propriété, qui indique si l’objet SafeHandle a fini 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.
