Server.EnumPerformanceCounters Method (String, String)

Enumerates a list of performance counters that are supported by the instance of Microsoft SQL Server for a specified object and specified counter.

Namespace: Microsoft.SqlServer.Management.Smo
Assembly: Microsoft.SqlServer.Smo (in microsoft.sqlserver.smo.dll)

Syntax

'Declaration
Public Function EnumPerformanceCounters ( _
    objectName As String, _
    counterName As String _
) As DataTable
public DataTable EnumPerformanceCounters (
    string objectName,
    string counterName
)
public:
DataTable^ EnumPerformanceCounters (
    String^ objectName, 
    String^ counterName
)
public DataTable EnumPerformanceCounters (
    String objectName, 
    String counterName
)
public function EnumPerformanceCounters (
    objectName : String, 
    counterName : String
) : DataTable

Parameters

  • objectName
    A String value that specifies the object on which to limit the results.
  • counterName
    A String value that specifies the counter name on which to limit the results.

Return Value

A DataTable object value that contains a list of performance counters supported by the instance of SQL Server. The table describes the different columns of the returned DataTable.

Column

Data type

Description

ObjectName

String

The name of the performance counter object. The SqlServer.ExecStatistics object, for example.

CounterName

String

The name of the performance counter. The Distributed Query counter, for example.

InstanceName

String

The name of the measurement to be taken. The Exec started per second instance, for example.

Remarks

Updated text:

This method enumerates all the performance counters available in SQL Server that you could use to create a performance alert. You can also see the performance counters listed in Using SQL Server Objects.

This namespace, class, or member is supported only in version 2.0 of the Microsoft .NET Framework.

Example

'Connect to the local, default instance of SQL Server.
Dim srv As Server
srv = New Server
'Call the EnumCollations method and return collation information to DataTable variable.
Dim d As DataTable
'Select the returned data into an array of DataRow.
d = srv.EnumCollations
'Iterate through the rows and display collation details for the instance of SQL Server.
Dim r As DataRow
Dim c As DataColumn
For Each r In d.Rows
    Console.WriteLine("============================================")
    For Each c In r.Table.Columns
        Console.WriteLine(c.ColumnName + " = " + r(c).ToString)
    Next
Next

Thread Safety

Any public static (Shared in Microsoft Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005.

Target Platforms

For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005.

See Also

Reference

Server Class
Server Members
Microsoft.SqlServer.Management.Smo Namespace

Other Resources

How to: Use an Enumeration Method that Returns a DataTable Object in Visual Basic .NET
Using SQL Server Objects
Calling Methods
Managing Servers

Change History

Release

History

New content:
  • Added code sample to the Example section.

  • Added to the description in the Remarks section.