SafeHandle.IsInvalid プロパティ

定義

名前空間:

System.Runtime.InteropServices

アセンブリ:

mscorlib.dll, System.Runtime.Handles.dll

アセンブリ:

System.Runtime.dll

アセンブリ:

System.Runtime.Handles.dll

アセンブリ:

mscorlib.dll

アセンブリ:

System.Runtime.InteropServices.dll

アセンブリ:

netstandard.dll

派生クラスでオーバーライドされると、ハンドル値が無効かどうかを示す値を取得します。

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。それ以外の場合は false。

例

次の例では、ファイルが正常に開かれたかどうかを確認します。 このコード例は、SafeHandle クラスのために提供されている大規模な例の一部です。

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

注釈

共通言語ランタイムが重要な終了処理が IsInvalid 必要かどうかを判断できるように、派生クラスはプロパティを実装する必要があります。 派生クラスは、サポートされている一般的な種類のハンドルに適した実装を提供する必要があります (0 または -1 は無効です)。 これらのクラスは、特定のセーフ ハンドル型に対してさらに派生させることができます。

基になるハンドルを IsClosed 使用してオブジェクトが終了したかどうかを SafeHandle 報告するプロパティとは異なり、プロパティは、 IsInvalid 指定されたハンドル値が常に無効と見なされるかどうかを計算します。 したがって、プロパティは常に IsInvalid 1 つのハンドル値に対して同じ値を返します。