PerformanceCounter.InstanceName Propriedade
Definição
Obtém ou define um nome de instância para o contador de desempenho.Gets or sets an instance name for this performance counter.
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; }
[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
[<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 da propriedade
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.The name of the performance counter category instance, or an empty string (""), if the counter is a single-instance counter.
- Atributos
Exemplos
O exemplo de código a seguir cria uma instância padrão da PerformanceCounter classe.The following code example creates a default instance of the PerformanceCounter class. Depois que a instância é criada, CategoryName os CounterName valores de propriedade,, e InstanceName são definidos, e os resultados de uma chamada para o NextValue método são exibidos.After the instance is created, the CategoryName, CounterName, and InstanceName property values are set, and the results of a call to the NextValue method are displayed.
PerformanceCounter^ PC = gcnew PerformanceCounter;
PC->CategoryName = "Process";
PC->CounterName = "Private Bytes";
PC->InstanceName = "Explorer";
MessageBox::Show( PC->NextValue().ToString() );
PerformanceCounter PC=new PerformanceCounter();
PC.CategoryName="Process";
PC.CounterName="Private Bytes";
PC.InstanceName="Explorer";
MessageBox.Show(PC.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 de comprimento.Instance names must be shorter than 128 characters in length.
Em algumas situações, as categorias são subdivididas em instâncias, que controlam dados sobre várias ocorrências do objeto ao qual uma categoria se relaciona.In some situations, categories are subdivided into instances, which track data about multiple occurrences of the object that a category relates to. As instâncias se aplicam à categoria como um todo, em vez de a contadores individuais.Instances apply to the category as whole, rather than to individual counters. Cada contador dentro de uma categoria tem cada instância definida para a categoria.Every counter within a category has each instance defined for the category. Por exemplo, a categoria Process contém instâncias chamadas Idle e System.For example, the Process category contains instances named Idle and System. Cada contador na categoria de processo contém, portanto, dados para cada instância, mostrando informações sobre processos ociosos ou processos do sistema.Every counter within the Process category thus contains data for each instance, showing information about either idle processes or system processes.
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.Many categories do not contain multiple instances, so you can leave this property empty to indicate that no instance is associated with the category.
Se essa PerformanceCounter instância apontar para uma categoria não personalizada, você poderá escolher apenas as instâncias de categoria existentes.If this PerformanceCounter instance points to a noncustom category, you can choose from only the existing category instances. Você pode criar novas instâncias de categoria somente em categorias personalizadas, que permitem definir quantos contadores e instâncias de categoria forem necessários.You can create new category instances only in custom categories, which allow you to define as many counters and category instances as you need.
Para criar uma instância de categoria de desempenho, especifique um instanceName no PerformanceCounter Construtor.To create a performance category instance, specify an instanceName on the PerformanceCounter constructor. Se a instância de categoria especificada por instanceName já existir, o novo objeto fará referência à instância de categoria existente.If the category instance specified by instanceName already exists the new object will reference the existing category instance.
Observação
Não use os caracteres "(", ")", "#", " \ " ou "/" no nome da instância.Do not use the characters "(", ")", "#", "\", or "/" in the instance name. Se qualquer um desses caracteres for usado, o console de desempenho (consulte criação de perfil de tempo de execução) poderá não exibir corretamente os valores de instância.If any of these characters are used, the Performance Console (see Runtime Profiling) may not correctly display the instance values.
Se o nome da instância for gerado automaticamente e puder conter os caracteres "(", ")", "#", " \ " ou "/", use o mapeamento de caracteres na tabela a seguir.If the instance name is automatically generated and might contain the characters "(", ")", "#", "\", or "/", use the character mapping in the following table.
| CaractereCharacter | Caractere mapeadoMapped character |
|---|---|
| (( | [[ |
| )) | ]] |
| # | |
| || | |
| / |
A FriendlyName Propriedade do AppDomain objeto obtido da AppDomain.CurrentDomain propriedade é uma fonte comum de nomes de instância que pode conter caracteres inválidos.The FriendlyName property of the AppDomain object obtained from the AppDomain.CurrentDomain property is a common source of instance names that can contain invalid characters.