PerformanceCounter.CounterName Property

Definition

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.PerformanceCounter.dll

Package:

System.Diagnostics.PerformanceCounter v9.0.0-rc.2.24473.5

Source:

PerformanceCounter.cs

Gets or sets the name of the performance counter that is associated with this PerformanceCounter instance.

public:
 property System::String ^ CounterName { System::String ^ get(); void set(System::String ^ value); };

public string CounterName { get; set; }

member this.CounterName : string with get, set

Public Property CounterName As String

Property Value

String

The name of the counter, which generally describes the quantity being counted. This name is displayed in the list of counters of the Performance Counter Manager MMC snap in's Add Counters dialog box.

Exceptions

ArgumentNullException

The CounterName is null.

Examples

The following code example shows how to set the CounterName property to a typical counter name.

PerformanceCounter^ PC = gcnew PerformanceCounter;
PC->CategoryName = "Process";
PC->CounterName = "Private Bytes";
PC->InstanceName = "Explorer";
MessageBox::Show( PC->NextValue().ToString() );

PerformanceCounter performanceCounter = new PerformanceCounter();
performanceCounter.CategoryName = "Process";
performanceCounter.CounterName = "Private Bytes";
performanceCounter.InstanceName = "Explorer";
MessageBox.Show(performanceCounter.NextValue().ToString());

Dim PC As New PerformanceCounter()
PC.CategoryName = "Process"
PC.CounterName = "Private Bytes"
PC.InstanceName = "Explorer"
MessageBox.Show(PC.NextValue().ToString())

Remarks

You can get a list of available pre-existing counters from the Windows Performance Manager's Add Counters dialog box.