PerformanceCounterCategory Constructor (String)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Initializes a new instance of the PerformanceCounterCategory class, sets the CategoryName property to the specified value, and sets the MachineName property to the local computer.

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

public PerformanceCounterCategory(
	string categoryName


Type: System.String

The name of the performance counter category, or performance object, with which to associate this PerformanceCounterCategory instance.

Exception Condition

The categoryName is an empty string ("").


The categoryName is null.

The following code example accepts a PerformanceCounterCategory name and a computer name from the command line. It creates a PerformanceCounterCategory using the constructor overload that is appropriate for the number of parameters provided, then displays its properties.

public static void Main(string[] args)
    string categoryName = "";
    string machineName = "";
    PerformanceCounterCategory pcc;

    // Copy the supplied arguments into the local variables.
        categoryName = args[0];
        machineName = args[1]=="."? "": args[1];
    catch(Exception ex)
        // Ignore the exception from non-supplied arguments.

    // Create a PerformanceCounterCategory object using 
    // the appropriate constructor.
    if (categoryName.Length==0)
        pcc = new PerformanceCounterCategory();
    else if(machineName.Length==0)
        pcc = new PerformanceCounterCategory(categoryName);
        pcc = new PerformanceCounterCategory(categoryName, machineName);

    // Display the properties of the PerformanceCounterCategory object.
        Console.WriteLine("  Category:  {0}", pcc.CategoryName);
        Console.WriteLine("  Computer:  {0}", pcc.MachineName);
        Console.WriteLine("  Help text: {0}", pcc.CategoryHelp);
    catch(Exception ex)
        Console.WriteLine("Error getting the properties of the " +
            "PerformanceCounterCategory object:");


for reading category information, such as the category name. Associated enumeration: PerformanceCounterPermissionAccess.Read.

.NET Framework
Available since 1.1
Return to top