PerformanceCounter.InstanceName 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 um nome de instância para o contador de desempenho.

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

public string InstanceName { get; set; }

member this.InstanceName : string with get, set

Public Property InstanceName As String

Valor da propriedade

String

O nome da instância de categoria do contador de desempenho ou uma cadeia de caracteres vazia (""), se o contador for um contador de instância única.

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

Observação

Os nomes de instância devem ter menos de 128 caracteres.

Em algumas situações, as categorias são subdivididas em instâncias, que acompanham dados sobre várias ocorrências do objeto ao qual uma categoria se relaciona. As instâncias se aplicam à categoria como um todo, em vez de a contadores individuais. Cada contador dentro de uma categoria tem cada instância definida para a categoria. Por exemplo, a categoria Processo contém instâncias chamadas Idle e System. Cada contador dentro da categoria Processo contém, portanto, dados para cada instância, mostrando informações sobre processos ociosos ou processos do sistema.

Muitas categorias não contêm várias instâncias, portanto, você pode deixar essa propriedade vazia para indicar que nenhuma instância está associada à categoria.

Se essa PerformanceCounter instância apontar para uma categoria não personalizada, você poderá escolher apenas entre as instâncias de categoria existentes. Você pode criar novas instâncias de categoria somente em categorias personalizadas, que permitem definir quantos contadores e instâncias de categoria precisarem.

Para criar uma instância de categoria de desempenho, especifique um instanceName no PerformanceCounter construtor. Se a instância de categoria especificada por instanceName já existir, o novo objeto fará referência à instância de categoria existente.

Observação

Não use os caracteres "(", ")", "#", "\" ou "/" no nome da instância. Se qualquer um desses caracteres for usado, o Console de Desempenho (consulte Criação de Perfil de Runtime) poderá não exibir corretamente os valores da instância.

Se o nome da instância for gerado automaticamente e pode conter os caracteres "(", ")", "#", "\" ou "/", use o mapeamento de caracteres na tabela a seguir.

Caractere	Caractere mapeado
(	[
)	]
#	_
\	_
/	_

A FriendlyName propriedade do AppDomain objeto obtida da AppDomain.CurrentDomain propriedade é uma fonte comum de nomes de instância que podem conter caracteres inválidos.