SafeHandle.IsInvalid Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft beim Überschreiben in einer abgeleiteten Klasse einen Wert ab, der angibt, ob dieses Handle ungültig ist.
public:
abstract property bool IsInvalid { bool get(); };public abstract bool IsInvalid { get; }member this.IsInvalid : boolPublic MustOverride ReadOnly Property IsInvalid As BooleanEigenschaftswert
true, wenn der Handlewert ungültig ist, andernfalls false.
Beispiele
Im folgenden Beispiel wird überprüft, ob eine Datei erfolgreich geöffnet wurde. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die SafeHandle-Klasse bereitgestellt wird.
// Determine if file is opened successfully.
if (_handle.IsInvalid)
throw new Win32Exception(Marshal.GetLastWin32Error(), fileName);
Hinweise
Abgeleitete Klassen müssen die IsInvalid -Eigenschaft implementieren, damit die Common Language Runtime bestimmen kann, ob eine kritische Finalisierung erforderlich ist. Abgeleitete Klassen müssen eine Implementierung bereitstellen, die dem allgemeinen Typ des von ihnen unterstützten Handles entspricht (0 oder -1 ist ungültig). Diese Klassen können dann für bestimmte sichere Handle-Typen weiter abgeleitet werden.
IsClosed Im Gegensatz zur -Eigenschaft, die angibt, ob das SafeHandle Objekt mit dem zugrunde liegenden Handle fertig ist, berechnet die IsInvalid -Eigenschaft, ob der angegebene Handle-Wert immer als ungültig gilt. Daher gibt die IsInvalid -Eigenschaft immer den gleichen Wert für einen beliebigen Handle-Wert zurück.
