PerformanceCounterCategory.Create Метод

Определение

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

System.Diagnostics

Сборка:

System.Diagnostics.PerformanceCounter.dll

Пакет:

System.Diagnostics.PerformanceCounter v11.0.0-preview.7.26381.103

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

Перегрузки

Имя	Описание
Create(String, String, String, String)	Устаревшие. Регистрирует пользовательскую категорию счетчика производительности, содержащую один счетчик типа NumberOfItems32 на локальном компьютере.
Create(String, String, PerformanceCounterCategoryType, String, String)	Регистрирует пользовательскую категорию счетчика производительности, содержащую один счетчик типа NumberOfItems32 на локальном компьютере.
Create(String, String, CounterCreationDataCollection)	Устаревшие. Регистрирует пользовательскую категорию счетчиков производительности, содержащую указанные счетчики на локальном компьютере.
Create(String, String, PerformanceCounterCategoryType, CounterCreationDataCollection)	Регистрирует пользовательскую категорию счетчиков производительности, содержащую указанные счетчики на локальном компьютере.

Create(String, String, String, String)

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

PerformanceCounterCategory.cs

Внимание!

This overload of PerformanceCounterCategory.Create has been deprecated. Use System.Diagnostics.PerformanceCounterCategory.Create(string categoryName, string categoryHelp, PerformanceCounterCategoryType categoryType, string counterName, string counterHelp) instead.

Регистрирует пользовательскую категорию счетчика производительности, содержащую один счетчик типа NumberOfItems32 на локальном компьютере.

public:
 static System::Diagnostics::PerformanceCounterCategory ^ Create(System::String ^ categoryName, System::String ^ categoryHelp, System::String ^ counterName, System::String ^ counterHelp);

[System.Obsolete("This overload of PerformanceCounterCategory.Create has been deprecated. Use System.Diagnostics.PerformanceCounterCategory.Create(string categoryName, string categoryHelp, PerformanceCounterCategoryType categoryType, string counterName, string counterHelp) instead.")]
public static System.Diagnostics.PerformanceCounterCategory Create(string categoryName, string categoryHelp, string counterName, string counterHelp);

[<System.Obsolete("This overload of PerformanceCounterCategory.Create has been deprecated. Use System.Diagnostics.PerformanceCounterCategory.Create(string categoryName, string categoryHelp, PerformanceCounterCategoryType categoryType, string counterName, string counterHelp) instead.")>]
static member Create : string * string * string * string -> System.Diagnostics.PerformanceCounterCategory

Public Shared Function Create (categoryName As String, categoryHelp As String, counterName As String, counterHelp As String) As PerformanceCounterCategory

Параметры

categoryName

String

Имя настраиваемой категории счетчика производительности для создания и регистрации в системе.

categoryHelp

String

Описание настраиваемой категории.

counterName

String

Имя нового счетчика NumberOfItems32типа, создаваемого в рамках новой категории.

counterHelp

String

Описание счетчика, связанного с новой пользовательской категорией.

Возвращаемое значение

PerformanceCounterCategory

Объект, PerformanceCounterCategory связанный с новой системной категорией или объектом производительности.

Атрибуты

ObsoleteAttribute

Исключения

ArgumentException

counterName имеет null или является пустой строкой ("").

–или–

Счетчик, указанный counterName уже существует.

–или–

counterName имеет недопустимый синтаксис. Он может содержать символы обратной косой черты ("\") или длину больше 80 символов.

InvalidOperationException

Категория уже существует на локальном компьютере.

ArgumentNullException

categoryName равно null.

–или–

counterHelp равно null.

Win32Exception

Сбой вызова базового системного API.

UnauthorizedAccessException

Код, выполняющийся без прав администратора, пытался прочитать счетчик производительности.

Комментарии

Note

Чтобы считывать счетчики производительности из сеанса входа в Windows Vista и более поздних версий, Windows XP Professional x64 Edition или Windows Server 2003, необходимо быть членом группы пользователей монитора производительности или иметь права администратора.

Чтобы избежать повышения привилегий для доступа к счетчикам производительности в Windows Vista и более поздних версий, добавьте себя в группу пользователей монитора производительности.

В Windows Vista и более поздних версиях контроль учетных записей (UAC) определяет привилегии пользователя. Если вы являетесь членом встроенной группы "Администраторы", вы назначаете два маркера доступа во время выполнения: маркер доступа стандартного пользователя и маркер доступа администратора. По умолчанию вы находитесь в стандартной роли пользователя. Чтобы выполнить код, который обращается к счетчикам производительности, необходимо сначала повысить привилегии от стандартного пользователя к администратору. Это можно сделать при запуске приложения, щелкнув правой кнопкой мыши значок приложения и указав, что вы хотите запустить от имени администратора.

См. также раздел

• Delete(String)
• Exists(String)
• PerformanceCounter
• CounterHelp

Create(String, String, PerformanceCounterCategoryType, String, String)

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

PerformanceCounterCategory.cs

Регистрирует пользовательскую категорию счетчика производительности, содержащую один счетчик типа NumberOfItems32 на локальном компьютере.

public:
 static System::Diagnostics::PerformanceCounterCategory ^ Create(System::String ^ categoryName, System::String ^ categoryHelp, System::Diagnostics::PerformanceCounterCategoryType categoryType, System::String ^ counterName, System::String ^ counterHelp);

public static System.Diagnostics.PerformanceCounterCategory Create(string categoryName, string categoryHelp, System.Diagnostics.PerformanceCounterCategoryType categoryType, string counterName, string counterHelp);

static member Create : string * string * System.Diagnostics.PerformanceCounterCategoryType * string * string -> System.Diagnostics.PerformanceCounterCategory

Public Shared Function Create (categoryName As String, categoryHelp As String, categoryType As PerformanceCounterCategoryType, counterName As String, counterHelp As String) As PerformanceCounterCategory

Параметры

categoryName

String

Имя настраиваемой категории счетчика производительности для создания и регистрации в системе.

categoryHelp

String

Описание настраиваемой категории.

categoryType

PerformanceCounterCategoryType

Одно из значений PerformanceCounterCategoryType , указывающее, является MultiInstanceли категория , SingleInstanceили Unknown.

counterName

String

Имя нового счетчика, создаваемого в рамках новой категории.

counterHelp

String

Описание счетчика, связанного с новой пользовательской категорией.

Возвращаемое значение

PerformanceCounterCategory

Объект, PerformanceCounterCategory связанный с новой системной категорией или объектом производительности.

Исключения

ArgumentException

counterName имеет null или является пустой строкой ("").

–или–

Счетчик, указанный counterName уже существует.

–или–

counterName имеет недопустимый синтаксис. Он может содержать символы обратной косой черты ("\") или длину больше 80 символов.

InvalidOperationException

Категория уже существует на локальном компьютере.

ArgumentNullException

categoryName равно null.

–или–

counterHelp равно null.

Win32Exception

Сбой вызова базового системного API.

UnauthorizedAccessException

Код, выполняющийся без прав администратора, пытался прочитать счетчик производительности.

Примеры

В следующем примере кода показано использование Create метода. В примере показано, как создать пользовательскую категорию счетчика производительности одного экземпляра.

Console.WriteLine("Creating Inventory custom counter");
if (!PerformanceCounterCategory.Exists("Inventory"))
    PerformanceCounterCategory.Create("Inventory",
        "Truck inventory",
        PerformanceCounterCategoryType.SingleInstance,
        "Trucks", "Number of trucks on hand");

Console.WriteLine("Creating Inventory custom counter")
If Not PerformanceCounterCategory.Exists("Inventory") Then
    PerformanceCounterCategory.Create("Inventory", "Truck inventory", PerformanceCounterCategoryType.SingleInstance, "Trucks", "Number of trucks on hand")
End If

Комментарии

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

Категории счетчиков производительности, установленные с .NET используют отдельную общую память, при этом каждая категория счетчиков производительности имеет собственную память. Размер отдельной общей памяти можно указать, создав DWORD с именем FileMappingSize в разделе реестра HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\<имени> категории\Performance. Значение FileMappingSize имеет общий размер памяти категории. Размер по умолчанию — 131072 десятичное значение. Если значение FileMappingSize отсутствует, используется значение атрибута для элемента, fileMappingSize указанного performanceCounters в файле Machine.config, что приводит к дополнительным затратам на обработку файлов конфигурации. Вы можете реализовать улучшение производительности запуска приложения, задав размер сопоставления файлов в реестре.

Note

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

Note

Чтобы считывать счетчики производительности из сеанса входа в Windows Vista и более поздних версий, Windows XP Professional x64 Edition или Windows Server 2003, необходимо быть членом группы пользователей монитора производительности или иметь права администратора.

Чтобы избежать повышения привилегий для доступа к счетчикам производительности в Windows Vista и более поздних версий, добавьте себя в группу пользователей монитора производительности.

В Windows Vista и более поздних версиях контроль учетных записей (UAC) определяет привилегии пользователя. Если вы являетесь членом встроенной группы "Администраторы", вы назначаете два маркера доступа во время выполнения: маркер доступа стандартного пользователя и маркер доступа администратора. По умолчанию вы находитесь в стандартной роли пользователя. Чтобы выполнить код, который обращается к счетчикам производительности, необходимо сначала повысить привилегии от стандартного пользователя к администратору. Это можно сделать при запуске приложения, щелкнув правой кнопкой мыши значок приложения и указав, что вы хотите запустить от имени администратора.

См. также раздел

• Delete(String)
• Exists(String)
• PerformanceCounter
• CounterCreationDataCollection

Create(String, String, CounterCreationDataCollection)

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

PerformanceCounterCategory.cs

Внимание!

This overload of PerformanceCounterCategory.Create has been deprecated. Use System.Diagnostics.PerformanceCounterCategory.Create(string categoryName, string categoryHelp, PerformanceCounterCategoryType categoryType, CounterCreationDataCollection counterData) instead.

Регистрирует пользовательскую категорию счетчиков производительности, содержащую указанные счетчики на локальном компьютере.

public:
 static System::Diagnostics::PerformanceCounterCategory ^ Create(System::String ^ categoryName, System::String ^ categoryHelp, System::Diagnostics::CounterCreationDataCollection ^ counterData);

[System.Obsolete("This overload of PerformanceCounterCategory.Create has been deprecated. Use System.Diagnostics.PerformanceCounterCategory.Create(string categoryName, string categoryHelp, PerformanceCounterCategoryType categoryType, CounterCreationDataCollection counterData) instead.")]
public static System.Diagnostics.PerformanceCounterCategory Create(string categoryName, string categoryHelp, System.Diagnostics.CounterCreationDataCollection counterData);

[<System.Obsolete("This overload of PerformanceCounterCategory.Create has been deprecated. Use System.Diagnostics.PerformanceCounterCategory.Create(string categoryName, string categoryHelp, PerformanceCounterCategoryType categoryType, CounterCreationDataCollection counterData) instead.")>]
static member Create : string * string * System.Diagnostics.CounterCreationDataCollection -> System.Diagnostics.PerformanceCounterCategory

Public Shared Function Create (categoryName As String, categoryHelp As String, counterData As CounterCreationDataCollection) As PerformanceCounterCategory

Параметры

categoryName

String

Имя настраиваемой категории счетчика производительности для создания и регистрации в системе.

categoryHelp

String

Описание настраиваемой категории.

counterData

CounterCreationDataCollection

Значение, CounterCreationDataCollection указывающее счетчики для создания в рамках новой категории.

Возвращаемое значение

PerformanceCounterCategory

Объект, PerformanceCounterCategory связанный с новой пользовательской категорией или объектом производительности.

Атрибуты

ObsoleteAttribute

Исключения

ArgumentException

Имя счетчика, указанное counterData в коллекции, является null пустой строкой ("").

–или–

Счетчик, указанный counterData в коллекции, уже существует.

ArgumentNullException

Параметр categoryName имеет значение null.

InvalidOperationException

Категория уже существует на локальном компьютере.

–или–

Неправильный counterData макет коллекции для базовых счетчиков. Счетчик типа , , , AverageCount64AverageTimer32CounterMultiTimerCounterMultiTimerInverseCounterMultiTimer100NsCounterMultiTimer100NsInverseили RawFraction должен быть немедленно за которым следует один из базовых типов счетчиков (SampleFraction, , SampleCounterAverageBaseили ).MultiBaseRawBaseSampleBase

Win32Exception

Сбой вызова базового системного API.

UnauthorizedAccessException

Код, выполняющийся без прав администратора, пытался прочитать счетчик производительности.

Комментарии

Note

Чтобы считывать счетчики производительности из сеанса входа в Windows Vista и более поздних версий, Windows XP Professional x64 Edition или Windows Server 2003, необходимо быть членом группы пользователей монитора производительности или иметь права администратора.

Чтобы избежать повышения привилегий для доступа к счетчикам производительности в Windows Vista и более поздних версий, добавьте себя в группу пользователей монитора производительности.

В Windows Vista и более поздних версиях контроль учетных записей (UAC) определяет привилегии пользователя. Если вы являетесь членом встроенной группы "Администраторы", вы назначаете два маркера доступа во время выполнения: маркер доступа стандартного пользователя и маркер доступа администратора. По умолчанию вы находитесь в стандартной роли пользователя. Чтобы выполнить код, который обращается к счетчикам производительности, необходимо сначала повысить привилегии от стандартного пользователя к администратору. Это можно сделать при запуске приложения, щелкнув правой кнопкой мыши значок приложения и указав, что вы хотите запустить от имени администратора.

См. также раздел

• Delete(String)
• Exists(String)
• PerformanceCounter
• CounterCreationDataCollection

Create(String, String, PerformanceCounterCategoryType, CounterCreationDataCollection)

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

PerformanceCounterCategory.cs

Регистрирует пользовательскую категорию счетчиков производительности, содержащую указанные счетчики на локальном компьютере.

public:
 static System::Diagnostics::PerformanceCounterCategory ^ Create(System::String ^ categoryName, System::String ^ categoryHelp, System::Diagnostics::PerformanceCounterCategoryType categoryType, System::Diagnostics::CounterCreationDataCollection ^ counterData);

public static System.Diagnostics.PerformanceCounterCategory Create(string categoryName, string categoryHelp, System.Diagnostics.PerformanceCounterCategoryType categoryType, System.Diagnostics.CounterCreationDataCollection counterData);

static member Create : string * string * System.Diagnostics.PerformanceCounterCategoryType * System.Diagnostics.CounterCreationDataCollection -> System.Diagnostics.PerformanceCounterCategory

Public Shared Function Create (categoryName As String, categoryHelp As String, categoryType As PerformanceCounterCategoryType, counterData As CounterCreationDataCollection) As PerformanceCounterCategory

Параметры

categoryName

String

Имя настраиваемой категории счетчика производительности для создания и регистрации в системе.

categoryHelp

String

Описание настраиваемой категории.

categoryType

PerformanceCounterCategoryType

Одно из значений PerformanceCounterCategoryType .

counterData

CounterCreationDataCollection

Значение, CounterCreationDataCollection указывающее счетчики для создания в рамках новой категории.

Возвращаемое значение

PerformanceCounterCategory

Объект, PerformanceCounterCategory связанный с новой пользовательской категорией или объектом производительности.

Исключения

ArgumentException

Имя счетчика, указанное counterData в коллекции, является null пустой строкой ("").

–или–

Счетчик, указанный counterData в коллекции, уже существует.

ArgumentNullException

categoryName равно null.

–или–

counterData равно null.

ArgumentOutOfRangeException

categoryType значение выходит за пределы диапазона следующих значений: MultiInstance, SingleInstanceили Unknown.

InvalidOperationException

Категория уже существует на локальном компьютере.

–или–

Неправильный counterData макет коллекции для базовых счетчиков. Счетчик типа AverageCount64, AverageTimer32, CounterMultiTimerCounterMultiTimerInverseCounterMultiTimer100NsCounterMultiTimer100NsInverseRawFractionSampleFractionили SampleCounter должен быть немедленно следовать одному из базовых типов счетчиков (AverageBase, , MultiBaseRawBaseили).SampleBase

Win32Exception

Сбой вызова базового системного API.

UnauthorizedAccessException

Код, выполняющийся без прав администратора, пытался прочитать счетчик производительности.

Примеры

В следующем примере кода показано использование Create метода. В примере показано, как создать пользовательскую категорию счетчиков производительности с несколькими экземплярами для количества заказов в секунду.

CounterCreationData data1 = new CounterCreationData("Trucks",
    "Number of orders", PerformanceCounterType.NumberOfItems32);
CounterCreationData data2 = new CounterCreationData("Rate of sales",
    "Orders/second", PerformanceCounterType.RateOfCountsPerSecond32);
CounterCreationDataCollection ccds = new CounterCreationDataCollection();
ccds.Add(data1);
ccds.Add(data2);
Console.WriteLine("Creating Orders custom counter.");
if (!PerformanceCounterCategory.Exists("Orders"))
    PerformanceCounterCategory.Create("Orders",
        "Processed orders",
        PerformanceCounterCategoryType.MultiInstance,
        ccds);

Dim data1 As New CounterCreationData("Trucks", "Number of orders", PerformanceCounterType.NumberOfItems32)
Dim data2 As New CounterCreationData("Rate of sales", "Orders/second", PerformanceCounterType.RateOfCountsPerSecond32)
Dim ccds As New CounterCreationDataCollection()
ccds.Add(data1)
ccds.Add(data2)
Console.WriteLine("Creating Orders custom counter.")
If Not PerformanceCounterCategory.Exists("Orders") Then
    PerformanceCounterCategory.Create("Orders", "Processed orders", PerformanceCounterCategoryType.MultiInstance, ccds)
End If

Комментарии

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

Категории счетчиков производительности, установленные с .NET используют отдельную общую память, при этом каждая категория счетчиков производительности имеет собственную память. Размер отдельной общей памяти можно указать, создав DWORD с именем FileMappingSize в разделе реестра HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\<имени> категории\Performance. Значение FileMappingSize имеет общий размер памяти категории. Размер по умолчанию — 131072 десятичное значение. Если значение FileMappingSize отсутствует, используется значение атрибута для элемента, fileMappingSize указанного performanceCounters в файле Machine.config, что приводит к дополнительным затратам на обработку файлов конфигурации. Вы можете реализовать улучшение производительности запуска приложения, задав размер сопоставления файлов в реестре.

Note

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

Note

Чтобы считывать счетчики производительности из сеанса входа в Windows Vista и более поздних версий, Windows XP Professional x64 Edition или Windows Server 2003, необходимо быть членом группы пользователей монитора производительности или иметь права администратора.

Чтобы избежать повышения привилегий для доступа к счетчикам производительности в Windows Vista и более поздних версий, добавьте себя в группу пользователей монитора производительности.

В Windows Vista и более поздних версиях контроль учетных записей (UAC) определяет привилегии пользователя. Если вы являетесь членом встроенной группы "Администраторы", вы назначаете два маркера доступа во время выполнения: маркер доступа стандартного пользователя и маркер доступа администратора. По умолчанию вы находитесь в стандартной роли пользователя. Чтобы выполнить код, который обращается к счетчикам производительности, необходимо сначала повысить привилегии от стандартного пользователя к администратору. Это можно сделать при запуске приложения, щелкнув правой кнопкой мыши значок приложения и указав, что вы хотите запустить от имени администратора.

См. также раздел

• Delete(String)
• Exists(String)
• PerformanceCounter
• CounterCreationDataCollection