PerformanceCounter.InstanceName Свойство

Определение

Пространство имен:

System.Diagnostics

Сборка:

System.Diagnostics.PerformanceCounter.dll

Пакет:

System.Diagnostics.PerformanceCounter v8.0.0

Исходный код:

PerformanceCounter.cs

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

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

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

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 свойства , является общим источником имен экземпляров, которые могут содержать недопустимые символы.