HandleCollector

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

HandleCollector クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

保留状態のハンドルを追跡し、指定したしきい値に達したときに、強制的にガベージ コレクションを実行します。

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

Visual Basic (宣言)

Public NotInheritable Class
 HandleCollector

Visual Basic (使用法)

Dim instance As HandleCollector

C#

public sealed class HandleCollector

C++

public ref class HandleCollector sealed

J#

public final class HandleCollector

JScript

public final class HandleCollector

解説

HandleCollector クラスは、アンマネージ リソースを識別する、限定された数のハンドルを追跡します。通常、アンマネージ リソースは、HDC や HWnd などを識別するハンドルを含みます。

継承階層

System.Object
  System.Runtime.InteropServices.HandleCollector

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

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

参照

関連項目
HandleCollector メンバ
System.Runtime.InteropServices 名前空間

HandleCollector コンストラクタ (String, Int32)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

名前およびハンドル コレクションを開始するしきい値を使用して、HandleCollector クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    name As String, _
    initialThreshold As Integer _
)

Visual Basic (使用法)

Dim name As String
Dim initialThreshold As Integer

Dim instance As New HandleCollector(name,
 initialThreshold)

C#

public HandleCollector (
    string name,
    int initialThreshold
)

C++

public:
HandleCollector (
    String^ name, 
    int initialThreshold
)

J#

public HandleCollector (
    String name, 
    int initialThreshold
)

JScript

public function HandleCollector (
    name : String, 
    initialThreshold : int
)

パラメータ

name

コレクタの名前。このパラメータにより、ハンドルの種類を個別に追跡するコレクタに名前を付けることができます。

initialThreshold

コレクションを開始するポイントを指定する値。

例外

例外の種類	条件
ArgumentOutOfRangeException	initialThreshold パラメータが 0 未満です。

プラットフォーム

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

参照

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

HandleCollector コンストラクタ (String, Int32, Int32)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

名前、ハンドル コレクションを開始するしきい値、およびハンドル コレクションを強制的に実行するしきい値を使用して、HandleCollector クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    name As String, _
    initialThreshold As Integer, _
    maximumThreshold As Integer _
)

Visual Basic (使用法)

Dim name As String
Dim initialThreshold As Integer
Dim maximumThreshold As Integer

Dim instance As New HandleCollector(name,
 initialThreshold, maximumThreshold)

C#

public HandleCollector (
    string name,
    int initialThreshold,
    int maximumThreshold
)

C++

public:
HandleCollector (
    String^ name, 
    int initialThreshold, 
    int maximumThreshold
)

J#

public HandleCollector (
    String name, 
    int initialThreshold, 
    int maximumThreshold
)

JScript

public function HandleCollector (
    name : String, 
    initialThreshold : int, 
    maximumThreshold : int
)

パラメータ

name

コレクタの名前。このパラメータにより、ハンドルの種類を個別に追跡するコレクタに名前を付けることができます。

initialThreshold

コレクションを開始するポイントを指定する値。

maximumThreshold

コレクションを強制的に実行するポイントを指定する値。この値は、使用できるハンドルの最大数に設定する必要があります。

例外

例外の種類	条件
ArgumentOutOfRangeException	initialThreshold パラメータが 0 未満です。 または maximumThreshold パラメータが 0 未満です。
ArgumentException	maximumThreshold パラメータが initialThreshold パラメータ未満です。

プラットフォーム

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

参照

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

HandleCollector コンストラクタ

オーバーロードの一覧

名前	説明
HandleCollector (String, Int32)	名前およびハンドル コレクションを開始するしきい値を使用して、HandleCollector クラスの新しいインスタンスを初期化します。
HandleCollector (String, Int32, Int32)	名前、ハンドル コレクションを開始するしきい値、およびハンドル コレクションを強制的に実行するしきい値を使用して、HandleCollector クラスの新しいインスタンスを初期化します。

参照

関連項目

HandleCollector クラス
HandleCollector メンバ
System.Runtime.InteropServices 名前空間

HandleCollector プロパティ

パブリック プロパティ

	名前	説明
	Count	収集したハンドルの数を取得します。
	InitialThreshold	コレクションを開始するポイントを指定する値を取得します。
	MaximumThreshold	コレクションを強制的に実行するポイントを指定する値を取得します。
	Name	HandleCollector オブジェクトの名前を取得します。

参照

関連項目

HandleCollector クラス
System.Runtime.InteropServices 名前空間

HandleCollector メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Add	現在のハンドル カウントをインクリメントします。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	Remove	現在のハンドル カウントをデクリメントします。
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

HandleCollector クラス
System.Runtime.InteropServices 名前空間

HandleCollector メンバ

保留状態のハンドルを追跡し、指定したしきい値に達したときに、強制的にガベージ コレクションを実行します。

HandleCollector データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	HandleCollector	オーバーロードされます。

パブリック プロパティ

	名前	説明
	Count	収集したハンドルの数を取得します。
	InitialThreshold	コレクションを開始するポイントを指定する値を取得します。
	MaximumThreshold	コレクションを強制的に実行するポイントを指定する値を取得します。
	Name	HandleCollector オブジェクトの名前を取得します。

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Add	現在のハンドル カウントをインクリメントします。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	Remove	現在のハンドル カウントをデクリメントします。
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

HandleCollector クラス
System.Runtime.InteropServices 名前空間