Compartilhar via


CounterSet.CreateCounterSetInstance(String) Método

Definição

Cria uma instância do 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

Nome da instância. O nome deve ser exclusivo.

Retornos

Uma instância do conjunto de contadores que conterá os dados do contador.

Atributos

Exceções

O nome da instância é NULL.

Você deve adicionar contadores ao conjunto de contadores antes de criar uma instância do conjunto de contadores.

Exemplos

Para ver um exemplo, consulte System.Diagnostics.PerformanceData.

Comentários

Chame esse método uma vez para conjuntos de contadores de instância única e uma ou mais vezes para conjuntos de contadores de várias instâncias.

O provedor determina quando cria uma instância. Se os dados do contador forem mais estáticos, o provedor poderá criar uma instância no momento da inicialização. Por exemplo, o número de processadores em um computador seria considerado estático, portanto, um provedor que fornece dados de contador para processadores poderia criar uma instância para cada processador no computador no momento da inicialização. Para contadores mais dinâmicos, como disco ou contadores de processo, os provedores criariam as novas instâncias em resposta a um novo dispositivo USB que está sendo adicionado ou a um novo processo sendo criado.

O provedor deve manter os dados do contador atualizados o tempo todo.

Aplica-se a