SafeHandle.IsInvalid Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Wanneer deze wordt overschreven in een afgeleide klasse, wordt een waarde opgehaald die aangeeft of de ingangswaarde ongeldig is.
public:
abstract property bool IsInvalid { bool get(); };public abstract bool IsInvalid { get; }member this.IsInvalid : boolPublic MustOverride ReadOnly Property IsInvalid As BooleanWaarde van eigenschap
true als de ingangswaarde ongeldig is; anders, false.
Voorbeelden
In het volgende voorbeeld wordt gecontroleerd of een bestand is geopend. Dit codevoorbeeld maakt deel uit van een groter voorbeeld voor de SafeHandle klasse.
// Determine if file is opened successfully.
if (_handle.IsInvalid)
throw new Win32Exception(Marshal.GetLastWin32Error(), fileName);
Opmerkingen
Afgeleide klassen moeten de IsInvalid eigenschap implementeren, zodat de algemene taalruntime kan bepalen of kritieke finalisatie vereist is. Afgeleide klassen moeten een implementatie bieden die past bij het algemene type handle dat ze ondersteunen (0 of -1 is ongeldig). Deze klassen kunnen vervolgens verder worden afgeleid voor specifieke typen veilige ingangen.
In tegenstelling tot de IsClosed eigenschap, die rapporteert of het SafeHandle object is voltooid met behulp van de onderliggende ingang, berekent de IsInvalid eigenschap of de opgegeven ingangswaarde altijd als ongeldig wordt beschouwd. Daarom retourneert de IsInvalid eigenschap altijd dezelfde waarde voor een ingangswaarde.