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 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 à
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour