SafeHandle.IsInvalid Eigenschaft

Definition

Namespace:

System.Runtime.InteropServices

Assembly:

System.Runtime.dll

Quelle:

SafeHandle.cs

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 : bool

Public MustOverride ReadOnly Property IsInvalid As Boolean

Eigenschaftswert

Boolean

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 das zugrunde liegende Handle verwendet hat, berechnet die IsInvalid Eigenschaft, ob der angegebene Handlewert immer als ungültig betrachtet wird. Daher gibt die IsInvalid -Eigenschaft immer den gleichen Wert für einen einzelnen Handlewert zurück.