Compartir a través de


CounterSet.CreateCounterSetInstance(String) Método

Definición

Crea una instancia del conjunto de contadores.

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

Parámetros

instanceName
String

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

Devoluciones

Una instancia del conjunto de contadores que contendrá los datos del contador.

Atributos

Excepciones

El nombre de instancia es NULL.

Deben agregarse 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 va a agregar o a un nuevo proceso que se va a crear.

El proveedor debe mantener actualizados los datos del contador en todo momento.

Se aplica a