CounterSet.CreateCounterSetInstance(String) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Cria uma instância do conjunto de contadores.
public:
System::Diagnostics::PerformanceData::CounterSetInstance ^ CreateCounterSetInstance(System::String ^ instanceName);[System.Security.SecurityCritical]
public System.Diagnostics.PerformanceData.CounterSetInstance CreateCounterSetInstance(string instanceName);public System.Diagnostics.PerformanceData.CounterSetInstance CreateCounterSetInstance(string instanceName);[<System.Security.SecurityCritical>]
member this.CreateCounterSetInstance : string -> System.Diagnostics.PerformanceData.CounterSetInstancemember this.CreateCounterSetInstance : string -> System.Diagnostics.PerformanceData.CounterSetInstancePublic Function CreateCounterSetInstance (instanceName As String) As CounterSetInstanceParâmetros
- instanceName
- String
Nome da instância. O nome tem de ser exclusivo.
Devoluções
Uma instância do conjunto de contadores que conterá os dados do contador.
- Atributos
Exceções
O nome da instância é NULL.
Deve adicionar contadores ao conjunto de contadores antes de criar uma instância do conjunto de contadores.
Exemplos
Para obter um exemplo, consulte System.Diagnostics.PerformanceData.
Observações
Chame-se a este método uma vez para conjuntos de contadores de instância única e uma ou mais vezes para conjuntos de contadores de múltiplas instâncias.
O fornecedor determina quando cria uma instância. Se os dados do contador forem mais estáticos, o fornecedor pode criar uma instância no momento da inicialização. Por exemplo, o número de processadores num computador seria considerado estático, pelo que um fornecedor que fornece dados contadores para processadores poderia criar uma instância para cada processador no computador no momento da inicialização. Para contadores mais dinâmicos, como contadores de disco ou de processo, os fornecedores criam as novas instâncias em resposta à adição de um novo dispositivo USB ou à criação de um novo processo.
O fornecedor deve manter os dados do contador up-todata em todos os momentos.