CounterSet.CreateCounterSetInstance(String) Método

Definición

Crea una instancia del conjunto de contadores.

public:
 System::Diagnostics::PerformanceData::CounterSetInstance ^ CreateCounterSetInstance(System::String ^ instanceName);
[System.Security.SecurityCritical]
public System.Diagnostics.PerformanceData.CounterSetInstance CreateCounterSetInstance(string instanceName);
public System.Diagnostics.PerformanceData.CounterSetInstance CreateCounterSetInstance(string instanceName);
[<System.Security.SecurityCritical>]
member this.CreateCounterSetInstance : string -> System.Diagnostics.PerformanceData.CounterSetInstance
member this.CreateCounterSetInstance : string -> System.Diagnostics.PerformanceData.CounterSetInstance
Public Function CreateCounterSetInstance (instanceName As String) As CounterSetInstance

Parámetros

instanceName
String

Nombre de la instancia. El nombre debe ser único.

Devoluciones

Instancia del conjunto de contadores que contendrá los datos del contador.

Atributos

Excepciones

El nombre de instancia es NULL.

Debe agregar contadores al conjunto de contadores antes de crear una instancia del conjunto de contadores.

Ejemplos

Para obtener un ejemplo, consulte System.Diagnostics.PerformanceData.

Comentarios

Llame a este método una vez para conjuntos de contadores de instancia única y una o varias veces para conjuntos de contadores de varias instancias.

El proveedor determina cuándo crea una instancia. Si los datos del contador son más estáticos, el proveedor puede crear una instancia en el momento de la inicialización. Por ejemplo, el número de procesadores de un equipo se consideraría estático, por lo que un proveedor que proporciona datos de contador para los procesadores podría crear una instancia para cada procesador del equipo en el momento de la inicialización. En el caso de los contadores que son más dinámicos, como los contadores de disco o proceso, los proveedores crearían las nuevas instancias en respuesta a un nuevo dispositivo USB que se agrega o se crea un nuevo proceso.

El proveedor debe mantener los datos del contador up-to-date en todo momento.

Se aplica a