CounterSet.CreateCounterSetInstance(String) Método

Definição

Namespace:

System.Diagnostics.PerformanceData

Assembly:

System.Diagnostics.PerformanceCounter.dll

Pacote:

System.Diagnostics.PerformanceCounter v8.0.0

Origem:

CounterSet.cs

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);

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

CounterSetInstance

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

Exceções

ArgumentException

O nome da instância é NULL.

InvalidOperationException

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.