PerformanceCounter.InstanceName Propriedade

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

public string InstanceName { get; set; }

[System.ComponentModel.TypeConverter("System.Diagnostics.Design.InstanceNameConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string InstanceName { get; set; }

[System.ComponentModel.TypeConverter("System.Diagnostics.Design.InstanceNameConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string InstanceName { get; set; }

[System.ComponentModel.SettingsBindable(true)]
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.InstanceNameConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string InstanceName { get; set; }

member this.InstanceName : string with get, set

[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.InstanceNameConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.InstanceName : string with get, set

[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.InstanceNameConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.InstanceName : string with get, set

[<System.ComponentModel.SettingsBindable(true)>]
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.InstanceNameConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.InstanceName : string with get, set

Public Property InstanceName As String

Valor de Propriedade

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

Atributos

TypeConverterAttribute SettingsBindableAttribute

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

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

Muitas categorias não contêm múltiplas instâncias, por isso pode deixar esta propriedade vazia para indicar que nenhuma instância está associada à categoria.

Se esta PerformanceCounter instância apontar para uma categoria não personalizada, pode escolher apenas entre as instâncias existentes da categoria. Podes criar novas instâncias de categoria apenas em categorias personalizadas, o que te permite definir tantos contadores e instâncias de categoria quanto precisares.

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 irá referenciar a instância de categoria existente.

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

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