InstanceDataCollectionCollection.Contains(String) 메서드

정의

네임스페이스:

System.Diagnostics

어셈블리:

System.Diagnostics.PerformanceCounter.dll

패키지:

System.Diagnostics.PerformanceCounter v8.0.0

Source:

InstanceDataCollectionCollection.cs

인덱싱된 InstanceDataCollection 개체 중 하나로 식별되는 지정된 카운터의 인스턴스 데이터 컬렉션이 해당 컬렉션에 존재하는지 여부를 확인합니다.

public:
 bool Contains(System::String ^ counterName);

public bool Contains (string counterName);

member this.Contains : string -> bool

Public Function Contains (counterName As String) As Boolean

매개 변수

counterName

String

성능 카운터의 이름입니다.

반환

Boolean

지정된 카운터를 포함하는 인스턴스 데이터 컬렉션이 해당 컬렉션에 있으면 true이고, 그렇지 않으면 false입니다.

예외

ArgumentNullException

counterName 매개 변수가 null인 경우

예제

다음 코드 예제에서는 명령줄에서 PerformanceCounter 범주 이름 및 카운터 이름을 허용합니다. 에 대한 를 InstanceDataCollectionCollectionPerformanceCounterCategory 가져온 다음 메서드를 Contains 사용하여 지정된 카운터가 있는지 확인합니다. 카운터가 있는 경우 이 예제에서는 연결된 를 InstanceDataCollection 가져오고 컬렉션의 instance 이름을 표시합니다.

public static void Main(string[] args)
{
    // The following values can be used as arguments.
    string categoryName = "Process";
    string counterName = "Private Bytes";

    InstanceDataCollectionCollection idColCol;

    // Copy the supplied arguments into the local variables.
    try
    {
        categoryName = args[0];
        counterName = args[1];
    }
    catch
    {
        // Ignore the exception from non-supplied arguments.
    }

    try
    {
        // Get the InstanceDataCollectionCollection for this category.
        PerformanceCounterCategory pcc = new PerformanceCounterCategory(categoryName);
        idColCol = pcc.ReadCategory();
    }
    catch(Exception ex)
    {
        Console.WriteLine("An error occurred getting the InstanceDataCollection for " +
            "category \"{0}\"."+ "\n" +ex.Message, categoryName);
        return;
    }

    // Check if this counter name exists using the Contains
    // method of the InstanceDataCollectionCollection.
    if (!idColCol.Contains(counterName))
    {
        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.
        InstanceDataCollection countData = idColCol[counterName];

        ICollection idColKeys = countData.Keys;
        string[] idColKeysArray = new string[idColKeys.Count];
        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.
        int index;
        for(index=0; index<idColKeysArray.Length; index++)
        {
            Console.WriteLine("{0,4} -- {1}", index+1, idColKeysArray[index]);
        }
    }
}

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

설명

매개 변수는 counterName 대/소문자를 구분하지 않습니다.

컬렉션의 각 InstanceDataCollection 개체에는 instance 대한 모든 카운터에 대한 성능 데이터가 포함됩니다. 데이터는 카운터 이름으로 인덱싱된 다음 instance 이름으로 인덱싱됩니다. Contains는 연결된 카운터에 InstanceDataCollection 매개 변수로 지정된 이름이 있는 개체가 있는 경우 를 counterName 반환 true 합니다.