PerformanceCounter.InstanceName Свойство

Определение

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

System.Diagnostics

Сборка:

System.Diagnostics.PerformanceCounter.dll

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

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

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 символов.

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

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

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

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

Замечание

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

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

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

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