InstanceDataCollectionCollection.Item プロパティ

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

InstanceDataCollectionCollection.Item プロパティ

指定したカウンタのインスタンス データを取得します。

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

Visual Basic (宣言)

Public ReadOnly Default
 Property Item ( _
    counterName As String _
) As InstanceDataCollection

Visual Basic (使用法)

Dim instance As InstanceDataCollectionCollection
Dim counterName As String
Dim value As InstanceDataCollection

value = instance(counterName)

C#

public InstanceDataCollection this [
    string counterName
] { get; }

C++

public:
property InstanceDataCollection^ default [String^] {
    InstanceDataCollection^ get (String^ counterName);
}

J#

/** @property */
public InstanceDataCollection get_Item (String counterName)

JScript

JScript では、インデックス付きのプロパティは使用できますが、新規に宣言することはできません。.

パラメータ

counterName

パフォーマンス カウンタの名前。

プロパティ値
InstanceDataCollectionCollection オブジェクトのインデックス作成に使用する InstanceDataCollection 項目。

例外

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

解説

counterName パラメータでは、大文字と小文字が区別されません。

コレクション内の各 InstanceDataCollection オブジェクトは、インスタンスのすべてのカウンタのパフォーマンス データを格納します。まずカウンタ名、次にインスタンス名を使用してデータのインデックスを作成します。インデクサは counterName パラメータを使用して、インスタンス データのコレクションに関連付けられているカウンタを処理します。

使用例

コマンド ラインから PerformanceCounter カテゴリ名およびカウンタ名を受け取るコード例を次に示します。PerformanceCounterCategory の InstanceDataCollectionCollection を取得します。次に、PerformanceCounter が存在する場合は、Item プロパティ (インデクサとして参照される) を使って関連付けられた InstanceDataCollection を取得し、コレクションからインスタンス名を表示します。

Visual Basic

Sub Main(ByVal args() As
 String)
    Dim categoryName As String
 = ""
    Dim counterName As String
 = ""

    Dim idColCol As InstanceDataCollectionCollection

    ' Copy the supplied arguments into the local variables.
    Try
        categoryName = args(0)
        counterName = args(1)
    Catch ex As Exception
        ' Ignore the exception from non-supplied arguments.
    End Try

    Try
        ' Get the InstanceDataCollectionCollection for this category.
        Dim pcc As New PerformanceCounterCategory(categoryName)
        idColCol = pcc.ReadCategory()
    Catch ex As Exception
        Console.WriteLine( _
            "An error occurred getting the InstanceDataCollection
 for " & _
            "category ""{0}""."
 & vbCrLf & ex.Message, categoryName)
        Return
    End Try

    ' Check if this counter name exists using the Contains
    ' method of the InstanceDataCollectionCollection.
    If Not idColCol.Contains(counterName) Then
        Console.WriteLine( _
            "Counter ""{0}""
 does not exist in category ""{1}"".",
 _
            counterName, categoryName)
        Return
    Else
        ' Now get the counter's InstanceDataCollection object using
 the
        ' indexer (Item property) for the InstanceDataCollectionCollection.
        Dim countData As InstanceDataCollection
 = idColCol(counterName)

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

        Console.WriteLine("Counter ""{0}""
 of category ""{1}""
 " & _
            "has {2} instances.", counterName, categoryName,
 idColKeys.Count)

        ' Display the instance names for this counter.
        Dim index As Integer
        For index = 0 To idColKeysArray.Length
 - 1
            Console.WriteLine("{0,4} -- {1}", index
 + 1, idColKeysArray(index))
        Next index
    End If
End Sub

プラットフォーム

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

参照

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