Compartilhar via


Como: Configurar PerformanceCounter componente Instances

Há uma variedade de propriedades que você deve conjunto sobre o PerformanceCounter componentes que você cria. Eles determinam o contador com os quais o componente interage.As propriedades que você deve conjunto incluem o seguinte:

  • CategoryName, que determina o objeto de desempenho com o qual o componente irá interagir. Todos sistema autônomo contadores de desempenho no Windows são agrupados por categorias, sistema autônomo memória, processos e processador.

  • CounterName, que identifica o contador na categoria especificada com o qual o componente irá interagir.

  • InstanceName, que identifica a instância da categoria com o qual o componente irá interagir. Observe que muitas categorias não contém instâncias.Portanto, essa propriedade pode ser deixada em branco.Isso indica um contador de instância única.

    Observação:

    Se a categoria tiver sido definida para uma categoria não foi definida pelo usuário, você deve escolher entre instâncias e contadores existentes.Você só pode criar novos contadores e instâncias de categorias personalizadas.Por exemplo, não é possível criar um novo contador na categoria memória, mas se você criar uma nova categoria chamada Orders, você pode definir tantas contadores e instâncias que você precisam nessa categoria.

  • MachineName, que identifica o servidor no qual reside o contador de desempenho com o qual deseja que seu componente para interagir. Você pode conjunto essa propriedade "." para indicar o computador local ou deixe em branco como padrão para esse valor.

  • ReadOnly, que determina se qualquer contador personalizado que você criar pode ser gravado. Por padrão, qualquer PerformanceCounter ocorrências de componente configurar para trabalhar com a função de contadores existente do Windows no modo somente leitura e não permitirá que você altere os valores desses contadores. No entanto, quando você configura sua instância do componente para trabalhar com um contador personalizado, você pode escolher para aceitar o padrão de trabalhar no modo somente leitura ou redefinir o valor da propriedade para false para permitir valores a serem gravados.

    Observação:

    Você pode gravar contadores somente no computador local.Se você pretende ler valores do contador, você pode escolher qualquer computador ao qual você tenha acesso.

Para configurar uma instância de componente contador de desempenho

  1. Criar uma instância do PerformanceCounter componente. Para obter mais informações, consulte Como: Criar instâncias de componentes do contador de desempenho.

  2. Indique o contador com as quais seu componente deve interagir, definindo as propriedades a seguintes.

    Propriedade

    Configuração

    MachineName

    Qualquer servidor ao qual você tem acesso.

    CategoryName

    Qualquer categoria que existe no servidor.

    CounterName

    Qualquer contador da categoria selecionada.

  3. Se o contador com sistema autônomo quais estão interagindo tiver várias instâncias, conjunto um apropriado sistema autônomo o valor do InstanceName propriedade.

  4. Se você estiver trabalhando com um contador personalizado e quiser acesso de gravar, conjunto o ReadOnly propriedade para false.

    Observação:

    Você pode especificar essas propriedades ou do Propriedades janela, no código ou usando formulários especiais do construtor para o PerformanceCounter instância do componente.

    O exemplo a seguir mostra como você poderia conjunto esses valores programaticamente para se conectar a um contador de desempenho do Windows existente chamado "transações anuladas" no servidor local.

    ' Connect to an existing Windows counter and category
    Dim abortedTransactions As New PerformanceCounter()
    abortedTransactions.CategoryName = _
       "distributed transaction coordinator"
    abortedTransactions.CounterName = "aborted transactions"
    abortedTransactions.MachineName = "."
    ' Connect to a custom counter and category in writable mode
    PerformanceCounterCategory.Create("orders", "desc", _
    PerformanceCounterCategoryType.SingleInstance, "milk", "desc")
    Dim myCounter2 As New PerformanceCounter("orders", "milk", False)
    
         // Connect to an existing Windows counter and category
            System.Diagnostics.PerformanceCounter abortedTransactions =
               new System.Diagnostics.PerformanceCounter();
            abortedTransactions.CategoryName =
               "distributed transaction coordinator";
            abortedTransactions.CounterName = "aborted transactions";
            abortedTransactions.MachineName = ".";
            // Connect to a custom counter and category in writable mode
            System.Diagnostics.PerformanceCounterCategory.Create(
               "orders", "desc", PerformanceCounterCategoryType.SingleInstance,
               "milk", "desc");
            System.Diagnostics.PerformanceCounter myCounter2 =
               new System.Diagnostics.PerformanceCounter("orders", "milk", false);
    
Observação:

Nesse código, "." representa o computador local.

Consulte também

Tarefas

Como: Criar instâncias de componentes do contador de desempenho

Como: Criar contadores de desempenho personalizado

Conceitos

Gerenciamento de contador e categoria