CounterSet.CreateCounterSetInstance(String) Método

Definición

Crea una instancia del conjunto de contadores.Creates an instance of the counter set.

public:
 System::Diagnostics::PerformanceData::CounterSetInstance ^ CreateCounterSetInstance(System::String ^ instanceName);
[System.Security.SecurityCritical]
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.Name of the instance. El nombre debe ser único.The name must be unique.

Devoluciones

Una instancia del conjunto de contadores que contendrá los datos del contador.An instance of the counter set which will contain the counter data.

Atributos

Excepciones

El nombre de instancia es NULL.The instance name is NULL.

Deben agregarse contadores al conjunto de contadores antes de crear una instancia del conjunto de contadores.You must add counters to the counter set before creating an instance of the counter set.

Ejemplos

Para obtener un ejemplo, vea System.Diagnostics.PerformanceData.For an example, see System.Diagnostics.PerformanceData.

Comentarios

Llame a este método una vez para los conjuntos de contadores de instancia única y una o varias veces para los conjuntos de contadores de varias instancias.Call this method one time for single-instance counter sets and one or more times for multiple-instance counter sets.

El proveedor determina cuándo crea una instancia.The provider determines when it creates an instance. Si los datos del contador son más estáticos, el proveedor puede crear una instancia en el momento de la inicialización.If the counter data is more static, the provider can create an instance at initialization time. Por ejemplo, el número de procesadores de un equipo se consideraría estático, por lo que un proveedor que proporcione datos de contador para procesadores podría crear una instancia para cada procesador del equipo en el momento de la inicialización.For example, the number of processors on a computer would be considered static, so a provider that provides counter data for processors could create an instance for each processor on the computer at initialization time. En el caso de los contadores más dinámicos, como los contadores de disco o de proceso, los proveedores crearían las nuevas instancias como respuesta a un nuevo dispositivo USB que se va a agregar o a un nuevo proceso que se va a crear.For counters that are more dynamic, such as disk or process counters, the providers would create the new instances in response to a new USB device being added or a new process being created.

El proveedor debe mantener los datos del contador actualizados en todo momento.The provider should keep the counter data up-to-date at all times.

Se aplica a