CounterCreationDataCollection.Insert(Int32, CounterCreationData) Methode

Definition

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.PerformanceCounter.dll

Assembly:

System.dll

Fügt ein CounterCreationData-Objekt am angegebenen Index in die Auflistung ein.

public:
 void Insert(int index, System::Diagnostics::CounterCreationData ^ value);

public void Insert (int index, System.Diagnostics.CounterCreationData value);

member this.Insert : int * System.Diagnostics.CounterCreationData -> unit

Public Sub Insert (index As Integer, value As CounterCreationData)

Parameter

index

Int32

Der nullbasierte Index der Position, an der die CounterCreationData-Instanz eingefügt werden soll.

value

CounterCreationData

Die in die Auflistung einzufügende CounterCreationData-Klasse.

Ausnahmen

ArgumentNullException

value ist null.

ArgumentException

value ist kein CounterCreationData-Objekt.

ArgumentOutOfRangeException

index ist kleiner als 0.

- oder - index ist größer als die Anzahl der Elemente in der Auflistung.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie mithilfe der Insert Methode ein CounterCreationData Objekt in ein Objekt CounterCreationDataCollectioneinfügen.

String^ myCategoryName;
int numberOfCounters;
Console::Write( "Enter the category Name : " );
myCategoryName = Console::ReadLine();
// Check if the category already exists or not.
if (  !PerformanceCounterCategory::Exists( myCategoryName ) )
{
   Console::Write( "Enter the number of counters : " );
   numberOfCounters = Int32::Parse( Console::ReadLine() );
   array<CounterCreationData^>^ myCounterCreationData =
      gcnew array<CounterCreationData^>(numberOfCounters);

   for ( int i = 0; i < numberOfCounters; i++ )
   {
      Console::Write( "Enter the counter name for {0} counter ", i );
      myCounterCreationData[ i ] = gcnew CounterCreationData;
      myCounterCreationData[ i ]->CounterName = Console::ReadLine();
   }
   CounterCreationDataCollection^ myCounterCollection =
      gcnew CounterCreationDataCollection( myCounterCreationData );
   CounterCreationData^ myInsertCounterCreationData = gcnew CounterCreationData(
      "CounterInsert","",PerformanceCounterType::NumberOfItems32 );
   // Insert an instance of 'CounterCreationData' in the 'CounterCreationDataCollection'.
   myCounterCollection->Insert( myCounterCollection->Count - 1,
      myInsertCounterCreationData );
   Console::WriteLine( "'{0}' counter is inserted into 'CounterCreationDataCollection'",
      myInsertCounterCreationData->CounterName );
   // Create the category.
   PerformanceCounterCategory::Create( myCategoryName, "Sample Category",
      myCounterCollection );

   for ( int i = 0; i < numberOfCounters; i++ )
   {
      myCounter = gcnew PerformanceCounter( myCategoryName,
         myCounterCreationData[ i ]->CounterName, "", false );
   }
   Console::WriteLine( "The index of '{0}' counter is {1}",
      myInsertCounterCreationData->CounterName, myCounterCollection->IndexOf( myInsertCounterCreationData ) );
}
else
{
   Console::WriteLine( "The category already exists" );
}

string myCategoryName;
int numberOfCounters;
Console.Write("Enter the category Name : ");
myCategoryName = Console.ReadLine();
// Check if the category already exists or not.
if (!PerformanceCounterCategory.Exists(myCategoryName))
{
    Console.Write("Enter the number of counters : ");
    numberOfCounters = int.Parse(Console.ReadLine());
    CounterCreationData[] myCounterCreationData =
       new CounterCreationData[numberOfCounters];

    for (int i = 0; i < numberOfCounters; i++)
    {
        Console.Write("Enter the counter name for {0} counter ", i);
        myCounterCreationData[i] = new CounterCreationData();
        myCounterCreationData[i].CounterName = Console.ReadLine();
    }
    CounterCreationDataCollection myCounterCollection =
       new CounterCreationDataCollection(myCounterCreationData);
    CounterCreationData myInsertCounterCreationData = new CounterCreationData(
       "CounterInsert", "", PerformanceCounterType.NumberOfItems32);
    // Insert an instance of 'CounterCreationData' in the 'CounterCreationDataCollection'.
    myCounterCollection.Insert(myCounterCollection.Count - 1,
       myInsertCounterCreationData);
    Console.WriteLine("'{0}' counter is inserted into 'CounterCreationDataCollection'",
       myInsertCounterCreationData.CounterName);
    // Create the category.
    PerformanceCounterCategory.Create(myCategoryName, "Sample Category",
    PerformanceCounterCategoryType.SingleInstance, myCounterCollection);

    for (int i = 0; i < numberOfCounters; i++)
    {
        myCounter = new PerformanceCounter(myCategoryName,
           myCounterCreationData[i].CounterName, "", false);
    }
    Console.WriteLine("The index of '{0}' counter is {1}",
       myInsertCounterCreationData.CounterName, myCounterCollection.IndexOf(myInsertCounterCreationData));
}
else
{
    Console.WriteLine("The category already exists");
}

Dim myCategoryName As String
Dim numberOfCounters As Integer
Console.Write("Enter the category Name : ")
myCategoryName = Console.ReadLine()
' Check if the category already exists or not.
If Not PerformanceCounterCategory.Exists(myCategoryName) Then
    Console.Write("Enter the number of counters : ")
    numberOfCounters = Integer.Parse(Console.ReadLine())
    Dim myCounterCreationData(numberOfCounters - 1) As CounterCreationData

    Dim i As Integer
    For i = 0 To numberOfCounters - 1
        Console.Write("Enter the counter name for {0} counter ", i)
        myCounterCreationData(i) = New CounterCreationData()
        myCounterCreationData(i).CounterName = Console.ReadLine()
    Next i
    Dim myCounterCollection As New CounterCreationDataCollection(myCounterCreationData)
    Dim myInsertCounterCreationData As New CounterCreationData("CounterInsert", "", _
                            PerformanceCounterType.NumberOfItems32)
    ' Insert an instance of 'CounterCreationData' in the 'CounterCreationDataCollection'.
    myCounterCollection.Insert(myCounterCollection.Count - 1, myInsertCounterCreationData)
    Console.WriteLine("'{0}' counter is inserted into 'CounterCreationDataCollection'", _
                            myInsertCounterCreationData.CounterName)
    ' Create the category.
    PerformanceCounterCategory.Create(myCategoryName, "Sample Category", _
       PerformanceCounterCategoryType.SingleInstance, myCounterCollection)

    For i = 0 To numberOfCounters - 1
        myCounter = New PerformanceCounter(myCategoryName, _
                                         myCounterCreationData(i).CounterName, "", False)
    Next i
    Console.WriteLine("The index of '{0}' counter is {1}", _
       myInsertCounterCreationData.CounterName, myCounterCollection.IndexOf(myInsertCounterCreationData))
Else
    Console.WriteLine("The category already exists")
End If