CounterCreationDataCollection.Remove Method (CounterCreationData)

 

Removes a CounterCreationData object from the collection.

Namespace:   System.Diagnostics
Assembly:  System (in System.dll)

public virtual void Remove(
	CounterCreationData value
)

Parameters

value
Type: System.Diagnostics.CounterCreationData

The CounterCreationData to remove from the collection.

Exception Condition
ArgumentNullException

value is null.

ArgumentException

value is not a CounterCreationData object.

-or-

value does not exist in the collection.

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

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");
}

.NET Framework
Available since 1.1
Return to top
Show: