Поделиться через


PerformanceCounter.InstanceName Свойство

Определение

Получает или задает имя экземпляра для этого счетчика производительности.

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

Значение свойства

Имя экземпляра категории счетчика производительности или пустая строка (""), если счетчик является единственным экземпляром.

Атрибуты

Примеры

В следующем примере кода создается экземпляр класса по умолчанию PerformanceCounter . После создания CategoryNameэкземпляра задаются значения свойств , CounterNameи InstanceName отображаются результаты вызова NextValue метода .

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())

Комментарии

Примечание

Имена экземпляров должны быть короче 128 символов.

В некоторых ситуациях категории подразделяются на экземпляры, которые отслеживают данные о нескольких вхождениях объекта, к которому относится категория. Экземпляры применяются к категории в целом, а не к отдельным счетчикам. Каждый счетчик в категории имеет каждый экземпляр, определенный для категории. Например, категория Процесс содержит экземпляры с именами Idle и System. Таким образом, каждый счетчик в категории "Процесс" содержит данные для каждого экземпляра, отображая сведения о неактивных процессах или системных процессах.

Многие категории не содержат несколько экземпляров, поэтому можно оставить это свойство пустым, чтобы указать, что ни один экземпляр не связан с категорией.

Если этот PerformanceCounter экземпляр указывает на ненастроенную категорию, можно выбрать только существующие экземпляры категории. Новые экземпляры категорий можно создавать только в пользовательских категориях, что позволяет определить столько счетчиков и экземпляров категорий, сколько вам нужно.

Чтобы создать экземпляр категории производительности, укажите в instanceName конструкторе PerformanceCounter . Если экземпляр категории, указанный параметром , instanceName уже существует, новый объект будет ссылаться на существующий экземпляр категории.

Примечание

Не используйте символы "(", "")", "#", "\" или "/" в имени экземпляра. Если используется какой-либо из этих символов, консоль производительности (см. профилирование среды выполнения) может неправильно отображать значения экземпляра.

Если имя экземпляра создается автоматически и может содержать символы "(", "")", "#", "\" или "/", используйте сопоставление символов в следующей таблице.

Символ Сопоставленный символ
( [
) ]
# _
\ _
/ _

Свойство FriendlyName объекта, полученное AppDomain из AppDomain.CurrentDomain свойства , является общим источником имен экземпляров, которые могут содержать недопустимые символы.

Применяется к