PerformanceCounter.CategoryName Propriedade

Definição

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.PerformanceCounter.dll

Pacote:

System.Diagnostics.PerformanceCounter v8.0.0

Origem:

PerformanceCounter.cs

Obtém ou define o nome da categoria do contador de desempenho desse contador de desempenho.

public:
 property System::String ^ CategoryName { System::String ^ get(); void set(System::String ^ value); };

public string CategoryName { get; set; }

member this.CategoryName : string with get, set

Public Property CategoryName As String

Valor da propriedade

String

O nome da categoria de contador de desempenho (objeto de desempenho) ao qual este contador de desempenho está associado.

Exceções

ArgumentNullException

O CategoryName é null.

Exemplos

O exemplo de código a seguir cria uma instância padrão da PerformanceCounter classe . Depois que a instância é criada, os CategoryNamevalores de propriedade , CounterNamee InstanceName são definidos e os resultados de uma chamada para o NextValue método são exibidos.

PerformanceCounter^ PC = gcnew PerformanceCounter;
PC->CategoryName = "Process";
PC->CounterName = "Private Bytes";
PC->InstanceName = "Explorer";
MessageBox::Show( PC->NextValue().ToString() );

PerformanceCounter performanceCounter = new PerformanceCounter();
performanceCounter.CategoryName = "Process";
performanceCounter.CounterName = "Private Bytes";
performanceCounter.InstanceName = "Explorer";
MessageBox.Show(performanceCounter.NextValue().ToString());

Dim PC As New PerformanceCounter()
PC.CategoryName = "Process"
PC.CounterName = "Private Bytes"
PC.InstanceName = "Explorer"
MessageBox.Show(PC.NextValue().ToString())

Comentários

O CategoryName é exibido no Performance Object campo de ajuste do MMC do Gerenciador de Contadores de Desempenho na caixa de diálogo.Add Counter

Um contador de desempenho monitora o comportamento de uma categoria ou objeto de desempenho em um computador. As categorias incluem componentes físicos (como processadores, discos e memória) e objetos do sistema (como processos e threads). Os contadores do sistema relacionados ao mesmo objeto de desempenho são agrupados em uma categoria que indica seu foco comum. Ao criar uma instância da PerformanceCounter classe, primeiro você indica a categoria com a qual o componente interagirá e, em seguida, escolhe um contador nessa categoria.

Por exemplo, uma categoria de contador do Windows é a categoria Memória. Os contadores do sistema nessa categoria rastreiam dados de memória, como o número de bytes disponíveis e o número de bytes armazenados em cache. Se você quisesse trabalhar com os bytes armazenados em cache em seu aplicativo, criaria uma instância do componente, conectaria-a PerformanceCounter à categoria Memória e, em seguida, escolheria o contador apropriado (nesse caso, Bytes armazenados em cache) nessa categoria.

Embora seu sistema disponibilize muito mais categorias de contador, as categorias com as quais você provavelmente interagirá com mais frequência são as categorias Cache, Memória, Objetos, PhysicalDisk, Processo, Processador, Servidor, Sistema e Thread.

Confira também

• ProcessName