InstanceDataCollection

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

InstanceDataCollection クラス

InstanceData オブジェクトの厳密に型指定されたコレクションを提供します。

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

Visual Basic (宣言)

Public Class InstanceDataCollection
    Inherits DictionaryBase

Visual Basic (使用法)

Dim instance As InstanceDataCollection

C#

public class InstanceDataCollection : DictionaryBase

C++

public ref class InstanceDataCollection : public
 DictionaryBase

J#

public class InstanceDataCollection extends
 DictionaryBase

JScript

public class InstanceDataCollection extends
 DictionaryBase

解説

InstanceDataCollection クラスは、カウンタのすべてのインスタンス データを格納しているコレクションを表します。このコレクションは、ReadCategory メソッドを使用するときに InstanceDataCollectionCollection に格納されます。

使用例

ローカル コンピュータ上の特定の PerformanceCounterCategory のインスタンス データを表示するコード例を次に示します。最初に、PerformanceCounterCategory 名の番号付けされたリストが表示されます。ユーザーがカテゴリの 1 つの番号を入力した後、その PerformanceCounterCategory の InstanceDataCollectionCollection が取得されます。次に、Values によって返されたコレクションが、InstanceDataCollection オブジェクトの配列に変換されます。各 InstanceDataCollection の各 InstanceData に関連付けられたインスタンス データも表示されます。

Visual Basic

Imports System
Imports System.Diagnostics
Imports System.Collections
Imports Microsoft.VisualBasic

Module InstDataKeysValuesMod

    Private categoryName As String

    Sub Main()
        Dim catNumStr As String
        Dim categoryNum As Integer

        Dim categories As PerformanceCounterCategory()
 = _
            PerformanceCounterCategory.GetCategories()

        Console.WriteLine( _
            "These categories are registered on this computer:")

        Dim catX As Integer
        For catX = 0 To categories.Length -
 1
            Console.WriteLine("{0,4} - {1}", catX
 + 1, _
                categories(catX).CategoryName)
        Next catX

        ' Ask the user to choose a category.
        Console.Write( _
            "Enter the category number from the above list: ")
        catNumStr = Console.ReadLine()

        ' Validate the entered category number.
        Try
            categoryNum = Integer.Parse(catNumStr)
            If categoryNum < 1 Or categoryNum
 > categories.Length Then
                Throw New Exception( _
                    String.Format("The category
 number must be in the " & _
                        "range 1..{0}.", categories.Length))
            End If
            categoryName = categories((categoryNum - 1)).CategoryName

        Catch ex As Exception
            Console.WriteLine("""{0}""
 is not a valid category number." &
 _
                vbCrLf & "{1}", catNumStr, ex.Message)
            Return
        End Try

        ' Process the InstanceDataCollectionCollection for this category.
        Dim pcc As New PerformanceCounterCategory(categoryName)
        Dim idColCol As InstanceDataCollectionCollection
 = pcc.ReadCategory()

        Dim idColColKeys As ICollection = idColCol.Keys
        Dim idCCKeysArray(idColColKeys.Count - 1) As
 String
        idColColKeys.CopyTo(idCCKeysArray, 0)

        Dim idColColValues As ICollection =
 idColCol.Values
        Dim idCCValuesArray(idColColValues.Count - 1) As
 InstanceDataCollection
        idColColValues.CopyTo(idCCValuesArray, 0)

        Console.WriteLine("InstanceDataCollectionCollection for
 ""{0}"" "
 & _
            "has {1} elements.", categoryName, idColCol.Count)

        ' Display the InstanceDataCollectionCollection Keys and Values.
        ' The Keys and Values collections have the same number of elements.
        Dim index As Integer
        For index = 0 To idCCKeysArray.Length
 - 1
            Console.WriteLine("  Next InstanceDataCollectionCollection
 " & _
                "Key is ""{0}""",
 idCCKeysArray(index))
            ProcessInstanceDataCollection(idCCValuesArray(index))
        Next index
    End Sub

    ' Display the contents of an InstanceDataCollection.
    Sub ProcessInstanceDataCollection(ByVal
 idCol As InstanceDataCollection)

        Dim idColKeys As ICollection = idCol.Keys
        Dim idColKeysArray(idColKeys.Count - 1) As
 String
        idColKeys.CopyTo(idColKeysArray, 0)

        Dim idColValues As ICollection = idCol.Values
        Dim idColValuesArray(idColValues.Count - 1) As
 InstanceData
        idColValues.CopyTo(idColValuesArray, 0)

        Console.WriteLine("  InstanceDataCollection for ""{0}""
 " & _
            "has {1} elements.", idCol.CounterName,
 idCol.Count)

        ' Display the InstanceDataCollection Keys and Values.
        ' The Keys and Values collections have the same number of elements.
        Dim index As Integer
        For index = 0 To idColKeysArray.Length
 - 1
            Console.WriteLine("    Next InstanceDataCollection
 " & _
                "Key is ""{0}""",
 idColKeysArray(index))
            ProcessInstanceDataObject(idColValuesArray(index))
        Next index
    End Sub

    ' Display the contents of an InstanceData object.
    Sub ProcessInstanceDataObject(ByVal instData
 As InstanceData)
        Dim sample As CounterSample = instData.Sample

        Console.WriteLine("    From InstanceData:"
 & vbCrLf & "      " & _
            "InstanceName: {0,-31} RawValue: {1}",
 _
            instData.InstanceName, instData.Sample.RawValue)
        Console.WriteLine("    From CounterSample:"
 & vbCrLf & "      " & _
            "CounterType: {0,-32} SystemFrequency: {1}"
 & vbCrLf & _
            "      BaseValue: {2,-34} RawValue: {3}"
 & vbCrLf & _
            "      CounterFrequency: {4,-27} CounterTimeStamp:
 {5}" & vbCrLf & _
            "      TimeStamp: {6,-34} TimeStamp100nSec: {7}",
 _
            sample.CounterType, sample.SystemFrequency, sample.BaseValue, _
            sample.RawValue, sample.CounterFrequency, sample.CounterTimeStamp, _
            sample.TimeStamp, sample.TimeStamp100nSec)
    End Sub
End Module

継承階層

System.Object
   System.Collections.DictionaryBase
    System.Diagnostics.InstanceDataCollection

スレッド セーフ

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

プラットフォーム

Windows 98, Windows 2000 SP4, 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、1.1、1.0

参照

関連項目
InstanceDataCollection メンバ
System.Diagnostics 名前空間
ReadCategory
InstanceDataCollectionCollection
InstanceData クラス
CounterSample 構造体

InstanceDataCollection コンストラクタ

メモ : このコンストラクタは、互換性のために残されています。

(パフォーマンス インスタンスを定義する) 指定したパフォーマンス カウンタを使用して、InstanceDataCollection クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

<ObsoleteAttribute("This constructor has been deprecated. 
 Please use System.Diagnostics.InstanceDataCollectionCollection.get_Item to get
 an instance of this collection instead.  http://go.microsoft.com/fwlink/?linkid=14202")> _
Public Sub New ( _
    counterName As String _
)

Visual Basic (使用法)

Dim counterName As String

Dim instance As New InstanceDataCollection(counterName)

C#

[ObsoleteAttribute("This constructor has been deprecated.  Please use System.Diagnostics.InstanceDataCollectionCollection.get_Item
 to get an instance of this collection instead.
  http://go.microsoft.com/fwlink/?linkid=14202")] 
public InstanceDataCollection (
    string counterName
)

C++

[ObsoleteAttribute(L"This constructor has been deprecated.  Please use System.Diagnostics.InstanceDataCollectionCollection.get_Item
 to get an instance of this collection instead.
  http://go.microsoft.com/fwlink/?linkid=14202")] 
public:
InstanceDataCollection (
    String^ counterName
)

J#

/** @attribute ObsoleteAttribute("This constructor has been deprecated.  Please
 use System.Diagnostics.InstanceDataCollectionCollection.get_Item to get
 an instance of this collection instead.  http://go.microsoft.com/fwlink/?linkid=14202") */ 
public InstanceDataCollection (
    String counterName
)

JScript

ObsoleteAttribute("This constructor has been deprecated.  Please use System.Diagnostics.InstanceDataCollectionCollection.get_Item
 to get an instance of this collection instead.
  http://go.microsoft.com/fwlink/?linkid=14202") 
public function InstanceDataCollection (
    counterName : String
)

パラメータ

counterName

カウンタの名前。カウンタは、通常、カウントされている数を示します。

例外

例外の種類	条件
ArgumentNullException	counterName パラメータが null 参照 (Visual Basic では Nothing) です。

プラットフォーム

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

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

バージョン情報

.NET Framework
サポート対象 : 1.0、1.1
2.0 では、互換性のために残されています (コンパイル時に警告)

参照

関連項目
InstanceDataCollection クラス
InstanceDataCollection メンバ
System.Diagnostics 名前空間

InstanceDataCollection プロパティ

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	Count	DictionaryBase インスタンスに格納されている要素の数を取得します。 ( DictionaryBase から継承されます。)
	CounterName	インスタンス データを取得するパフォーマンス カウンタの名前を取得します。
	Item	このカウンタに関連付けられているインスタンス データを取得します。通常、これは一連の生のカウンタ値です。
	Keys	オブジェクトと、インスタンス データに関連付けられているオブジェクトのカウンタ レジストリ キーを取得します。
	Values	カウンタのインスタンス データを構成する生のカウンタ値を取得します。

プロテクト プロパティ

	名前	説明
	Dictionary	DictionaryBase インスタンスに格納されている要素のリストを取得します。 ( DictionaryBase から継承されます。)
	InnerHashtable	DictionaryBase インスタンスに格納されている要素のリストを取得します。 ( DictionaryBase から継承されます。)

参照

関連項目

InstanceDataCollection クラス
System.Diagnostics 名前空間
ReadCategory
InstanceDataCollectionCollection
InstanceData クラス
CounterSample 構造体

InstanceDataCollection メソッド

パブリック メソッド

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

	名前	説明
	Clear	DictionaryBase インスタンスの内容を消去します。 ( DictionaryBase から継承されます。)
	Contains	(インデックスを作成した InstanceData オブジェクトの 1 つによって識別される) 指定した名前のパフォーマンス インスタンスが、コレクション内に存在しているかどうかを確認します。
	CopyTo	オーバーロードされます。 指定したインデックスを使用して、コレクションに項目の配列をコピーします。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetEnumerator	DictionaryBase インスタンスを反復処理する IDictionaryEnumerator を返します。 ( DictionaryBase から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)
	OnClear	DictionaryBase インスタンスの内容を消去する前に、追加のカスタム プロセスを実行します。 ( DictionaryBase から継承されます。)
	OnClearComplete	DictionaryBase インスタンスの内容を消去した後に、追加のカスタム プロセスを実行します。 ( DictionaryBase から継承されます。)
	OnGet	指定したキーおよび値を持つ、DictionaryBase インスタンスの要素を取得します。 ( DictionaryBase から継承されます。)
	OnInsert	DictionaryBase インスタンスに新しい要素を挿入する前に、追加のカスタム プロセスを実行します。 ( DictionaryBase から継承されます。)
	OnInsertComplete	DictionaryBase インスタンスに新しい要素を挿入した後に、追加のカスタム プロセスを実行します。 ( DictionaryBase から継承されます。)
	OnRemove	DictionaryBase インスタンスから要素を削除する前に、追加のカスタム プロセスを実行します。 ( DictionaryBase から継承されます。)
	OnRemoveComplete	DictionaryBase インスタンスから要素を削除した後に、追加のカスタム プロセスを実行します。 ( DictionaryBase から継承されます。)
	OnSet	DictionaryBase インスタンスに値を設定する前に、追加のカスタム プロセスを実行します。 ( DictionaryBase から継承されます。)
	OnSetComplete	DictionaryBase インスタンスに値を設定した後に、追加のカスタム プロセスを実行します。 ( DictionaryBase から継承されます。)
	OnValidate	指定したキーおよび値を持つ要素を検証するときに、追加のカスタム プロセスを実行します。 ( DictionaryBase から継承されます。)

参照

関連項目

InstanceDataCollection クラス
System.Diagnostics 名前空間
ReadCategory
InstanceDataCollectionCollection
InstanceData クラス
CounterSample 構造体

InstanceDataCollection メンバ

InstanceData オブジェクトの厳密に型指定されたコレクションを提供します。

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

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

	名前	説明
	InstanceDataCollection	(パフォーマンス インスタンスを定義する) 指定したパフォーマンス カウンタを使用して、InstanceDataCollection クラスの新しいインスタンスを初期化します。

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	Count	DictionaryBase インスタンスに格納されている要素の数を取得します。(DictionaryBase から継承されます。)
	CounterName	インスタンス データを取得するパフォーマンス カウンタの名前を取得します。
	Item	このカウンタに関連付けられているインスタンス データを取得します。通常、これは一連の生のカウンタ値です。
	Keys	オブジェクトと、インスタンス データに関連付けられているオブジェクトのカウンタ レジストリ キーを取得します。
	Values	カウンタのインスタンス データを構成する生のカウンタ値を取得します。

プロテクト プロパティ

	名前	説明
	Dictionary	DictionaryBase インスタンスに格納されている要素のリストを取得します。(DictionaryBase から継承されます。)
	InnerHashtable	DictionaryBase インスタンスに格納されている要素のリストを取得します。(DictionaryBase から継承されます。)

パブリック メソッド

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

	名前	説明
	Clear	DictionaryBase インスタンスの内容を消去します。 (DictionaryBase から継承されます。)
	Contains	(インデックスを作成した InstanceData オブジェクトの 1 つによって識別される) 指定した名前のパフォーマンス インスタンスが、コレクション内に存在しているかどうかを確認します。
	CopyTo	オーバーロードされます。 指定したインデックスを使用して、コレクションに項目の配列をコピーします。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetEnumerator	DictionaryBase インスタンスを反復処理する IDictionaryEnumerator を返します。 (DictionaryBase から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)
	OnClear	DictionaryBase インスタンスの内容を消去する前に、追加のカスタム プロセスを実行します。 (DictionaryBase から継承されます。)
	OnClearComplete	DictionaryBase インスタンスの内容を消去した後に、追加のカスタム プロセスを実行します。 (DictionaryBase から継承されます。)
	OnGet	指定したキーおよび値を持つ、DictionaryBase インスタンスの要素を取得します。 (DictionaryBase から継承されます。)
	OnInsert	DictionaryBase インスタンスに新しい要素を挿入する前に、追加のカスタム プロセスを実行します。 (DictionaryBase から継承されます。)
	OnInsertComplete	DictionaryBase インスタンスに新しい要素を挿入した後に、追加のカスタム プロセスを実行します。 (DictionaryBase から継承されます。)
	OnRemove	DictionaryBase インスタンスから要素を削除する前に、追加のカスタム プロセスを実行します。 (DictionaryBase から継承されます。)
	OnRemoveComplete	DictionaryBase インスタンスから要素を削除した後に、追加のカスタム プロセスを実行します。 (DictionaryBase から継承されます。)
	OnSet	DictionaryBase インスタンスに値を設定する前に、追加のカスタム プロセスを実行します。 (DictionaryBase から継承されます。)
	OnSetComplete	DictionaryBase インスタンスに値を設定した後に、追加のカスタム プロセスを実行します。 (DictionaryBase から継承されます。)
	OnValidate	指定したキーおよび値を持つ要素を検証するときに、追加のカスタム プロセスを実行します。 (DictionaryBase から継承されます。)

参照

関連項目

InstanceDataCollection クラス
System.Diagnostics 名前空間
ReadCategory
InstanceDataCollectionCollection
InstanceData クラス
CounterSample 構造体