SafeHandle.IsInvalid Vlastnost

Definice

Obor názvů:

System.Runtime.InteropServices

Sestavení:

netstandard.dll, System.Runtime.dll

Zdroj:

SafeHandle.cs

Při přepsání v odvozené třídě získá hodnotu označující, zda je hodnota popisovače neplatná.

public:
 abstract property bool IsInvalid { bool get(); };

public abstract bool IsInvalid { get; }

member this.IsInvalid : bool

Public MustOverride ReadOnly Property IsInvalid As Boolean

Hodnota vlastnosti

Boolean

truepokud je hodnota popisovače neplatná; v opačném případě . false

Příklady

Následující příklad zkontroluje, jestli byl soubor úspěšně otevřen. Tento příklad kódu je součástí většího příkladu uvedeného pro třídu SafeHandle.

// Determine if file is opened successfully.
if (_handle.IsInvalid)
    throw new Win32Exception(Marshal.GetLastWin32Error(), fileName);

Poznámky

Odvozené třídy musí implementovat IsInvalid vlastnost, aby modul CLR (Common Language Runtime) mohl určit, zda je vyžadována kritická finalizace. Odvozené třídy musí poskytovat implementaci, která odpovídá obecnému typu popisovače, který podporují (0 nebo -1 je neplatné). Tyto třídy pak mohou být dále odvozeny pro konkrétní typy bezpečných popisovačů.

IsClosed Na rozdíl od vlastnosti, která hlásí, zda SafeHandle objekt dokončil pomocí podkladového popisovače, IsInvalid vlastnost vypočítá, zda daná hodnota popisovače je vždy považována za neplatnou. IsInvalid Proto vlastnost vždy vrátí stejnou hodnotu pro libovolnou hodnotu popisovače.