Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

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

 

Publicado: octubre de 2016

Nota: Esta API ahora está obsoleta.

Registra una 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)

[<ObsoleteAttribute("This method has been deprecated.  Please use System.Diagnostics.PerformanceCounterCategory.Create(string categoryName, string categoryHelp, PerformanceCounterCategoryType categoryType, string counterName, string counterHelp) instead.  http://go.microsoft.com/fwlink/?linkid=14202")>]
static member Create : 
        categoryName:string *
        categoryHelp:string *
        counterName:string *
        counterHelp:string -> PerformanceCounterCategory

Parámetros

categoryName
Type: System.String

El nombre de la categoría de contador de rendimiento personalizado para crear y registrar con el sistema.

categoryHelp
Type: System.String

Descripción de la categoría personalizada.

counterName
Type: System.String

El nombre de un nuevo contador de tipo NumberOfItems32, a crear como parte de la nueva categoría.

counterHelp
Type: System.String

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

Valor devuelto

Type: System.Diagnostics.PerformanceCounterCategory

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

Exception Condition
ArgumentException

counterName es null o es una cadena vacía ("").

O bien

El contador especificado por counterName ya existe.

O bien

counterName tiene una sintaxis no válida. Podría contener caracteres de barra diagonal inversa ("\") o tiene longitud supere los 80 caracteres.

InvalidOperationException

La categoría ya existe en el equipo local.

ArgumentNullException

El valor de categoryName es null.

-o-

El valor de counterHelp es null.

Win32Exception

Error en una llamada a una API del sistema subyacente.

UnauthorizedAccessException

Código que se ejecuta sin privilegios administrativos intentó leer un contador de rendimiento.

System_CAPS_noteNota

Para leer los contadores de rendimiento en Windows Vista y versiones posteriores, Windows XP Professional x64 Edition o Windows Server 2003, debe ser miembro del grupo usuarios del Monitor de rendimiento o tener privilegios administrativos.

Para evitar tener que elevar sus privilegios para tener acceso a los contadores de rendimiento en Windows Vista y versiones posteriores, agréguese al grupo usuarios del Monitor de rendimiento.

En Windows Vista y versiones posteriores, el Control de cuentas de usuario (UAC) determina los privilegios de un usuario. Si es miembro del grupo Administradores integrados, se le asignarán dos símbolos (tokens) de acceso en tiempo de ejecución: un símbolo (token) de acceso de usuario estándar y un símbolo (token) de acceso de administrador. De forma predeterminada, se le asignará el rol de usuario estándar. Para ejecutar el código que tiene acceso a los contadores de rendimiento, primero debe elevar sus privilegios de usuario estándar a administrador. Para ello, inicie una aplicación haciendo clic con el botón derecho en el icono de la aplicación e indique que desea ejecutarla como administrador.

En el ejemplo de código siguiente se crea un PerformanceCounterCategory y único PerformanceCounter con texto de ayuda para cada uno, mediante el Create(String, String, String, String) método.

No hay ningún ejemplo de código disponible o este idioma no es compatible.

PerformanceCounterPermission

for performing administrative tasks on performance counter categories. Associated enumeration: F:System.Diagnostics.PerformanceCounterPermissionAccess.Administer.

.NET Framework
Disponible desde 1.1
Volver al principio
Mostrar: