SafeHandle.IsInvalid 屬性

定義

命名空間:

System.Runtime.InteropServices

組件:

netstandard.dll, System.Runtime.dll

來源:

SafeHandle.cs

當在派生類別中覆寫時，會獲得一個值，表示該句柄值是否無效。

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

public abstract bool IsInvalid { get; }

member this.IsInvalid : bool

Public MustOverride ReadOnly Property IsInvalid As Boolean

屬性值

Boolean

true如果 handle 值無效;否則，。 false

範例

以下範例檢查檔案是否成功開啟。 此程式碼範例是本類別更大範例 SafeHandle 的一部分。

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

備註

衍生類別必須實作此 IsInvalid 特性，使通用語言執行時能判斷是否需要關鍵終結。 衍生類別必須提供符合其一般類型handle的實作（0 或 -1 無效）。 這些類別接著可以進一步推導出特定安全把柄類型。

與 IsClosed 報告物件是否 SafeHandle 完成底層句柄的屬性不同，屬性 IsInvalid 計算給定的句柄值是否總是被視為無效。 因此，該 IsInvalid 屬性對任意一個 handle 值總是回傳相同的值。