SafeHandle.IsInvalid Vlastnost

Definice

Obor názvů:

System.Runtime.InteropServices

Sestavení:

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 SafeHandle pro třídu .

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

Poznámky

Odvozené třídy musí implementovat IsInvalid vlastnost tak, 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 lze dále odvodit pro konkrétní typy bezpečných popisovačů.

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