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.
Beim Überschreiben in einer abgeleiteten Klasse wird ein Wert abgerufen, der angibt, ob der Handlewert 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
truewenn 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 unterstützten Handles entspricht (0 oder -1 ist ungültig). Diese Klassen können dann für bestimmte sichere Handletypen weiter abgeleitet werden.
IsClosed Im Gegensatz zur Eigenschaft, die meldet, ob das SafeHandle Objekt mit dem zugrunde liegenden Handle fertig ist, berechnet die IsInvalid Eigenschaft, ob der angegebene Handlewert immer als ungültig angesehen wird. Daher gibt die IsInvalid Eigenschaft immer denselben Wert für einen einzelnen Handle-Wert zurück.
