SafeHandle.IsInvalid

.NET Framework クラス ライブラリ リファレンス

SafeHandle.IsInvalid プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

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

名前空間: System.Runtime.InteropServices
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public MustOverride ReadOnly
 Property IsInvalid As Boolean

Visual Basic (使用法)

Dim instance As SafeHandle
Dim value As Boolean

value = instance.IsInvalid

C#

public abstract bool IsInvalid { get;
 }

C++

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

J#

/** @property */
public abstract boolean get_IsInvalid ()

JScript

public abstract function get
 IsInvalid () : boolean

プロパティ値
ハンドルが有効な場合は true。それ以外の場合は false。

解説

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

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

使用例

SafeHandle クラスを実装する方法を次のコード例に示します。

C#

public override bool IsInvalid
{

    get { return IsClosed || handle == IntPtr.Zero;
 }
}

.NET Framework のセキュリティ

• SecurityPermission  (アンマネージ コードを呼び出すために必要なアクセス許可)。 UnmanagedCode (関連する列挙体)。LinkDemand (セキュリティ アクション)。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
SafeHandle クラス
SafeHandle メンバ
System.Runtime.InteropServices 名前空間

SafeHandle.IsInvalid プロパティ

名前空間: System.Security.Cryptography
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public MustOverride ReadOnly
 Property IsInvalid As Boolean

Visual Basic (使用法)

Dim instance As SafeHandle
Dim value As Boolean

value = instance.IsInvalid

C#

public abstract bool IsInvalid { get;
 }

C++

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

J#

/** @property */
public abstract boolean get_IsInvalid ()

JScript

public abstract function get
 IsInvalid () : boolean

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
SafeHandle クラス
SafeHandle メンバ
System.Security.Cryptography 名前空間