InstanceDataCollection.Item プロパティ

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

InstanceDataCollection.Item プロパティ

このカウンタに関連付けられているインスタンス データを取得します。通常、これは一連の生のカウンタ値です。

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

Visual Basic (宣言)

Public ReadOnly Default
 Property Item ( _
    instanceName As String _
) As InstanceData

Visual Basic (使用法)

Dim instance As InstanceDataCollection
Dim instanceName As String
Dim value As InstanceData

value = instance(instanceName)

C#

public InstanceData this [
    string instanceName
] { get; }

C++

public:
property InstanceData^ default [String^] {
    InstanceData^ get (String^ instanceName);
}

J#

/** @property */
public InstanceData get_Item (String instanceName)

JScript

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

パラメータ

instanceName

パフォーマンス カウンタ カテゴリ インスタンスの名前。カテゴリに含まれるインスタンスが 1 つだけの場合は空の文字列 ("")。

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

例外

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

解説

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

使用例

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

Visual Basic

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

    Dim idCol As InstanceDataCollection
    Const SINGLE_INSTANCE_NAME As String
 = _
        "systemdiagnosticsperfcounterlibsingleinstance"

    ' Copy the supplied arguments into the local variables.
    Try
        categoryName = args(0)
        counterName = args(1)
        instanceName = args(2)
    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)
        Dim idColCol As InstanceDataCollectionCollection
 = _
            pcc.ReadCategory()

        ' Get the InstanceDataCollection for this counter.
        idCol = idColCol(counterName)
        If idCol Is Nothing
 Then
            Throw New Exception("Counter
 does not exist.")
        End If
    Catch ex As Exception
        Console.WriteLine( _
            "An error occurred getting the InstanceDataCollection
 for " & _
            "category ""{0}"",
 counter ""{1}""."
 & vbCrLf & ex.Message, _
            categoryName, counterName)
        Return
    End Try

    ' If the instance name is empty, use the single-instance name.
    If instanceName.Length = 0 Then
        instanceName = SINGLE_INSTANCE_NAME
    End If

    ' Check if this instance name exists using the Contains
    ' method of the InstanceDataCollection.
    If Not idCol.Contains(instanceName) Then
        Console.WriteLine( _
            "Instance ""{0}""
 does not exist in counter ""{1}"",
 " & _
            "category ""{2}"".",
 instanceName, counterName, categoryName)
        Return
    Else
        ' The instance name exists, now get its InstanceData object
        ' using the indexer (Item property) for the InstanceDataCollection.
        Dim instData As InstanceData = idCol(instanceName)

        Console.WriteLine("CategoryName: {0}", categoryName)
        Console.WriteLine("CounterName:  {0}", counterName)
        Console.WriteLine("InstanceName: {0}", instData.InstanceName)
        Console.WriteLine("RawValue:     {0}", instData.RawValue)
    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

参照

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