CounterSet.CreateCounterSetInstance(String) Método

Definición

Espacio de nombres:

System.Diagnostics.PerformanceData

Ensamblado:

System.Diagnostics.PerformanceCounter.dll

Paquete:

System.Diagnostics.PerformanceCounter v8.0.0

Source:

CounterSet.cs

Crea una instancia del conjunto de contadores.

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

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

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

CounterSetInstance

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

Excepciones

ArgumentException

El nombre de instancia es NULL.

InvalidOperationException

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.