CounterSet.CreateCounterSetInstance(String) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
创建计数器集的一个实例。
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
实例的名称。 该名称必须是唯一的。
返回
将包含计数器数据的计数器集的实例。
- 属性
例外
实例名称为 NULL。
在为计数器集创建实例之前,必须先向其中添加计数器。
示例
有关示例,请参见 System.Diagnostics.PerformanceData。
注解
对单实例计数器集调用此方法一次,对多实例计数器集调用一次或多次。
提供程序确定何时创建实例。 如果计数器数据更静态,则提供程序可以在初始化时创建实例。 例如,计算机上的处理器数将被视为静态,因此为处理器提供计数器数据的提供程序可以在初始化时为计算机上的每个处理器创建实例。 对于动态性更高的计数器(例如磁盘或进程计数器),提供程序将创建新的实例,以响应正在添加新的 USB 设备或正在创建新进程。
提供程序应始终使计数器数据保持最新。