CounterCreationDataCollection.Remove(CounterCreationData) Method

Definition

Removes a CounterCreationData object from the collection.

C#
public virtual void Remove(System.Diagnostics.CounterCreationData value);

Parameters

value
CounterCreationData

The CounterCreationData to remove from the collection.

Exceptions

value is null.

value is not a CounterCreationData object.

-or-

value does not exist in the collection.

Examples

The following example demonstrates how to use the Remove method to delete a CounterCreationData object from the CounterCreationDataCollection.

C#
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();
    // Add the 'CounterCreationData[]' to 'CounterCollection'.
    myCounterCollection.AddRange(myCounterCreationData);

    PerformanceCounterCategory.Create(myCategoryName,
       "Sample Category",
    PerformanceCounterCategoryType.SingleInstance, myCounterCollection);

    if (myCounterCreationData.Length > 0)
    {
        if (myCounterCollection.Contains(myCounterCreationData[0]))
        {
            myCounterCollection.Remove(myCounterCreationData[0]);
            Console.WriteLine("'{0}' counter is removed from the " +
               "CounterCreationDataCollection", myCounterCreationData[0].CounterName);
        }
    }
    else
    {
        Console.WriteLine("The counters does not exist");
    }
}
else
{
    Console.WriteLine("The category already exists");
}

Applies to

Product Versions
.NET 8 (package-provided), 9 (package-provided), 10 (package-provided)
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0 (package-provided)
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9, 10