Esta documentación está archivada y no tiene mantenimiento.

PerformanceCounterCategory.Create (Método) (String, String, PerformanceCounterCategoryType, String, String)

Nota: este método es nuevo en la versión 2.0 de .NET Framework.

Registra la categoría de contador de rendimiento personalizada que contiene un solo contador de tipo NumberOfItems32 en el equipo local.

Espacio de nombres: System.Diagnostics
Ensamblado: System (en system.dll)

public static PerformanceCounterCategory Create (
	string categoryName,
	string categoryHelp,
	PerformanceCounterCategoryType categoryType,
	string counterName,
	string counterHelp
)
public static PerformanceCounterCategory Create (
	String categoryName, 
	String categoryHelp, 
	PerformanceCounterCategoryType categoryType, 
	String counterName, 
	String counterHelp
)
public static function Create (
	categoryName : String, 
	categoryHelp : String, 
	categoryType : PerformanceCounterCategoryType, 
	counterName : String, 
	counterHelp : String
) : PerformanceCounterCategory

Parámetros

categoryName

Nombre de la categoría de contador de rendimiento personalizada que se va a crear y registrar en el sistema.

categoryHelp

Descripción de la categoría personalizada.

categoryType

Uno de los valores de PerformanceCounterCategoryType que especifica si la categoría es MultiInstance, SingleInstance o Unknown.

counterName

Nombre de un nuevo contador que se va a crear como parte de la nueva categoría.

counterHelp

Descripción del contador asociado a la nueva categoría personalizada.

Valor devuelto

PerformanceCounterCategory que está asociado a la nueva categoría del sistema, u objeto de rendimiento.

Tipo de excepciónCondición

ArgumentException

counterName es referencia de objeto null (Nothing en Visual Basic) o una cadena vacía ("").

O bien

Ya existe el contador especificado por el parámetro counterName.

O bien

counterName tiene una sintaxis no válida. Puede que contenga caracteres de barra invertida ("\") o que su longitud supere los 80 caracteres.

InvalidOperationException

Ya existe la categoría en el equipo local.

ArgumentNullException

categoryName es referencia de objeto null (Nothing en Visual Basic).

O bien,

counterHelp es referencia de objeto null (Nothing en Visual Basic).

Win32Exception

Se ha producido un error en la llamada a una API del sistema subyacente.

El parámetro categoryType especifica si la categoría de contador de rendimiento es de una sola instancia o de varias instancias. De manera predeterminada, una categoría es de una sola instancia cuando se crea y se convierte en categoría de varias instancias al agregar otra instancia. Las categorías se crean cuando se configura una aplicación, y las instancias se agregan en tiempo de ejecución. En las versiones 1.0 y 1.1 de .NET Framework, no es preciso saber si la categoría de un contador de rendimiento es de una sola instancia o de varias. En Microsoft .NET Framework version 2.0, se utiliza la enumeración PerformanceCounterCategoryType para indicar si un contador de rendimiento puede tener varias instancias.

Las categorías de contador de rendimiento instaladas con .NET Framework 2.0 utilizan memoria compartida independiente, y cada categoría de contador de rendimiento tiene su propia memoria. Se puede especificar el tamaño de la memoria compartida independiente creando una clave del Registro DWORD, HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\<category name>\Performance\FileMappingSize con un valor como, por ejemplo, 131072, el valor predeterminado actual. Si la clave del Registro no está presente, se utiliza el valor del atributo fileMappingSize para el elemento performanceCounters especificado en el archivo Machine.config, lo que provoca una sobrecarga adicional en el procesamiento del archivo de configuración. Utilizando la clave del Registro podrá apreciar una mejora del rendimiento en el inicio de la aplicación.

En el siguiente ejemplo de código se muestra el uso del método Create. Se muestra cómo crear una categoría personalizada de contador de rendimiento de una sola instancia.

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

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter Edition

.NET Framework no admite todas las versiones de cada plataforma. Para obtener una lista de las versiones admitidas, vea Requisitos del sistema.

.NET Framework

Compatible con: 2.0
Mostrar: