PerformanceCounter.CategoryName Propriedade
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.
Recebe ou define o nome da categoria do contador de desempenho para este contador de desempenho.
public:
property System::String ^ CategoryName { System::String ^ get(); void set(System::String ^ value); };[System.ComponentModel.TypeConverter("System.Diagnostics.Design.CategoryValueConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string CategoryName { get; set; }[System.ComponentModel.TypeConverter("System.Diagnostics.Design.CategoryValueConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string CategoryName { get; set; }[System.ComponentModel.SettingsBindable(true)]
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.CategoryValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string CategoryName { get; set; }[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.CategoryValueConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.CategoryName : string with get, set[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.CategoryValueConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.CategoryName : string with get, set[<System.ComponentModel.SettingsBindable(true)>]
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.CategoryValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.CategoryName : string with get, setPublic Property CategoryName As StringValor de Propriedade
O nome da categoria do contador de desempenho (objeto de desempenho) com a qual este contador de desempenho está associado.
- Atributos
Exceções
O CategoryName é null.
Exemplos
O exemplo de código seguinte cria uma instância padrão da PerformanceCounter classe. Após a criação da instância, CategoryNameos valores de , CounterName, e InstanceName propriedades são definidos, e os resultados de uma chamada ao NextValue método são exibidos.
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())
Observações
É CategoryName exibido na Performance Object caixa de diálogo do Gestor de Contadores de Desempenho MMC Add Counter .
Um contador de desempenho monitoriza o comportamento de uma categoria, ou objeto de performance, num 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 com o mesmo objeto de desempenho são agrupados numa categoria que indica o seu foco comum. Quando crias uma instância da PerformanceCounter classe, primeiro indicas a categoria com a qual o componente irá interagir e depois escolhes um contador dessa categoria.
Por exemplo, uma categoria contador do Windows é a categoria Memória. Os contadores de sistema dentro desta categoria acompanham dados de memória, como o número de bytes disponíveis e o número de bytes em cache. Se quiser trabalhar com os bytes armazenados em cache na sua aplicação, criaria uma instância do PerformanceCounter componente, ligava-a à categoria Memória e depois escolhia o contador apropriado (neste caso, Bytes em Cache) dessa categoria.
Embora o seu sistema disponibilize muitas mais contracategorias, as categorias com que provavelmente irá interagir com mais frequência são as categorias Cache, Memória, Objetos, PhysicalDisk, Processo, Processador, Servidor, Sistema e Thread.