CounterSet.CreateCounterSetInstance(String) 方法

定义

命名空间:

System.Diagnostics.PerformanceData

程序集:

System.Diagnostics.PerformanceCounter.dll

程序集:

System.Core.dll

创建计数器集的一个实例。

public:
 System::Diagnostics::PerformanceData::CounterSetInstance ^ CreateCounterSetInstance(System::String ^ instanceName);

public System.Diagnostics.PerformanceData.CounterSetInstance CreateCounterSetInstance (string instanceName);

[System.Security.SecurityCritical]
public System.Diagnostics.PerformanceData.CounterSetInstance CreateCounterSetInstance (string instanceName);

member this.CreateCounterSetInstance : string -> System.Diagnostics.PerformanceData.CounterSetInstance

[<System.Security.SecurityCritical>]
member this.CreateCounterSetInstance : string -> System.Diagnostics.PerformanceData.CounterSetInstance

Public Function CreateCounterSetInstance (instanceName As String) As CounterSetInstance

参数

instanceName

String

实例的名称。 该名称必须是唯一的。

返回

CounterSetInstance

将包含计数器数据的计数器集的实例。

属性

SecurityCriticalAttribute

例外

ArgumentException

实例名称为 NULL。

InvalidOperationException

在为计数器集创建实例之前，必须先向其中添加计数器。

示例

有关示例，请参见 System.Diagnostics.PerformanceData。

注解

为单实例计数器集调用此方法一次，对多实例计数器集调用一次或多次。

提供程序确定何时创建实例。 如果计数器数据更静态，提供程序可以在初始化时创建实例。 例如，计算机上的处理器数被视为静态的，因此，为处理器提供计数器数据的提供程序可以在初始化时为计算机上的每个处理器创建一个实例。 对于更动态的计数器（如磁盘或进程计数器），提供程序将创建新的实例，以响应要添加的新 USB 设备或正在创建新进程。

提供程序应始终使计数器数据保持最新状态。