Como: Adicionar e remover instâncias do contador de desempenho

Você pode adicionar e remover instâncias dinamicamente à medida que trabalhar com categorias e contadores.Por exemplo, você pode adicionar uma instância para cada usuário de um aplicativo de varejo com base na Web para que pudessem controlar informações sobre suas ações e, em seguida, remova a instância quando a sessão do usuário expira.

Adicionar instâncias por configuração um valor não processado para um contador.Não se existir nenhuma instância do contador, uma instância é criada na primeira time que você defina o RawValue propriedade e todas as ações subseqüentes no valor bruto são considerados afetam essa instância se nenhum Outros for especificado. Você pode criar instâncias adicionais especificando um novo nome de instância e, em seguida, definindo um valor depois dela.

Observação:
O processo de configuração valor da instância do, em vez de especificar o nome de uma nova instância cria a instância.

Ao contrário dos contadores, que não podem ser adicionados a uma categoria existente, exceto sistema autônomo parte da criação de categoria, instâncias podem ser adicionadas ao e removidas das categorias definidas pelo usuário a qualquer momento.Você pode usar o InstanceName propriedade para comutador entre uma instância e o outro.

Você pode usar o RemoveInstance método para remover uma instância de um contador de desempenho personalizado da memória. Por exemplo, suponha que você tenha um aplicativo de varejo com base na Web que usa uma categoria chamada OrderInProgress e em que mantêm instâncias para o carrinho corrente de cada usuário.Quando um usuário primeiro adiciona um item ao seu carrinho, seu aplicativo cria uma nova instância desse usuário.Quando o usuário conclui a ordem, seu aplicativo exclui a instância.Durante a ordem, você pode atualizar a instância com contadores, sistema autônomo NumberofItemsinCart, TimeSinceCreation e NumberofItemsAddedPerSecond.

Não é possível remover instâncias dos contadores de desempenho que fazem parte do padrão do Windows.Se seu PerformanceCounter componente não faz referência a uma instância válida, esse método lançará uma exceção.

Observação:
O PerformanceCounter classe não tem suporte completo no Microsoft Windows NT versão 4.0. Você pode ler de contadores de sistema, mas não é possível criar, gravar ou excluir contadores personalizados.

Para adicionar uma instância do contador de desempenho

1. criar suas categorias e contadores normalmente.Para obter mais informações, consulte Como: Criar categorias de contador de desempenho.

2. Definir o InstanceName propriedade para um nome exclusivo para a instância e, em seguida, a instância do conjunto RawValue propriedade.

   O código a seguir mostra como criar várias instâncias de uma categoria de contador de desempenho existente:

   ' Assumes the category and counter have already been created.
   Dim myCounter As New System.Diagnostics.PerformanceCounter( _
      "cat", "counter", "instance1", False)
   ' Set the raw value to automatically create instance1.
   myCounter.RawValue = 100
   ' State that you will now be working with a different instance.
   myCounter.InstanceName = "instance2"
   ' Setting the value actually creates instance2.
   myCounter.RawValue = 200
   

        // Assumes category and counter have been created.
           System.Diagnostics.PerformanceCounter myCounter =
              new System.Diagnostics.PerformanceCounter(
              "cat", "counter", "instance1", false);
           // Set the raw value to automatically create instance1.
           myCounter.RawValue = 100;
           // State that you will now be working with a different instance.
           myCounter.InstanceName = "instance2";
           // Setting the value actually creates instance2.
           myCounter.RawValue = 200;
   
   

Para remover uma instância do contador de desempenho

1. Criar uma instância do PerformanceCounter componente que está conectado o contador do qual você deseja remover uma instância. Para obter mais informações, consulte Como: Criar instâncias de componentes do contador de desempenho.

2. conjunto o InstanceName propriedade para a instância que deseja excluir.

3. Chamar o RemoveInstance método no seu componente.

   O exemplo a seguir mostra como remover uma instância chamada Reference a partir de um contador:

   ' Assumes that you have configured PerformanceCounter1 to
   ' interact with the appropriate counter.
   PerformanceCounter1.InstanceName = "Reference"
   PerformanceCounter1.RemoveInstance()
   

        // Assumes that you have configured PerformanceCounter1 to
           // interact with the appropriate counter.
           PerformanceCounter1.InstanceName = "Reference";
           PerformanceCounter1.RemoveInstance();
   

Consulte também

Tarefas

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

Conceitos

Gerenciamento de contador e categoria