Windows apps
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

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

   PerformanceCounterCategory::Create( myCategoryName,
      "Sample Category", myCounterCollection );

   for ( int i = 0; i < numberOfCounters; i++ )
   {
      myCounter = gcnew PerformanceCounter( myCategoryName,
         myCounterCreationData[ i ]->CounterName, "", false );
   }
   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:
© 2017 Microsoft