Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original.
Traducción
Original

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

Nota: esta API ya está obsoleta.

Registra la categoría de contador de rendimiento personalizada que contiene los contadores especificados 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, CounterCreationDataCollection counterData) instead.  http://go.microsoft.com/fwlink/?linkid=14202")]
public static PerformanceCounterCategory Create(
	string categoryName,
	string categoryHelp,
	CounterCreationDataCollection counterData
)

Parámetros

categoryName
Tipo: System.String
Nombre de la categoría de contador de rendimiento personalizada que se va a crear y registrar en el sistema.
categoryHelp
Tipo: System.String
Descripción de la categoría personalizada.
counterData
Tipo: System.Diagnostics.CounterCreationDataCollection
CounterCreationDataCollection que especifica los contadores que se van a crear como parte de la nueva categoría.

Valor devuelto

Tipo: System.Diagnostics.PerformanceCounterCategory
PerformanceCounterCategory que está asociado a la nueva categoría personalizada, u objeto de rendimiento.

ExcepciónCondición
ArgumentException

Un nombre de contador especificado dentro de la colección counterData es null o una cadena vacía ("").

O bien

Un contador especificado dentro de la colección counterData ya existe.

O bien

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

ArgumentNullException

El valor del parámetro categoryName es null.

InvalidOperationException

Ya existe la categoría en el equipo local.

O bien

El diseño de la colección counterData es incorrecto para los contadores base. Un contador de tipo AverageCount64, AverageTimer32, CounterMultiTimer, CounterMultiTimerInverse, CounterMultiTimer100Ns, CounterMultiTimer100NsInverse, RawFraction, SampleFraction o SampleCounter debe ir seguido inmediatamente de uno de los tipos de contador base (AverageBase, MultiBase, RawBase o SampleBase).

Win32Exception

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

UnauthorizedAccessException

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

NotaNota

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

Para evitar la elevación de los privilegios de acceso a los contadores de rendimiento en Windows Vista y versiones posteriores, agregue su propio usuario al grupo Usuarios del monitor de sistema.

En Windows Vista y 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á la función de usuario estándar. Para ejecutar el código que tiene acceso a los contadores de rendimiento, primero debe elevar el nivel de sus privilegios de usuario estándar a administrador. Esto se puede hacer cuando se inicia una aplicación haciendo clic con el botón secundario del mouse en el icono de la aplicación e indicando que se desea ejecutar como administrador.

En el ejemplo de código siguiente se determina si existe un objeto PerformanceCounterCategory denominado "pedidos". Si no, crea el objeto PerformanceCounterCategory utilizando un objeto CounterCreationDataCollection que contiene dos contadores de rendimiento.


if (!PerformanceCounterCategory.Exists("Orders"))
{
    CounterCreationData milk = new CounterCreationData();
    milk.CounterName = "milk";
    milk.CounterType = PerformanceCounterType.NumberOfItems32;

    CounterCreationData milkPerSecond = new CounterCreationData();
    milkPerSecond.CounterName = "milk orders/second";
    milkPerSecond.CounterType = PerformanceCounterType.RateOfCountsPerSecond32;

    CounterCreationDataCollection ccds = new CounterCreationDataCollection();
    ccds.Add(milkPerSecond);
    ccds.Add(milk);

    PerformanceCounterCategory.Create("Orders", "Number of processed orders",
        PerformanceCounterCategoryType.SingleInstance, ccds);

}


.NET Framework

Compatible con: 1.1, 1.0
Obsoleto (advertencia del compilador) en 4
Obsoleto (advertencia del compilador) en 3.5
Obsoleto (advertencia del compilador) en 3.5 SP1
Obsoleto (advertencia del compilador) en 3.0
Obsoleto (advertencia del compilador) en 3.0 SP1
Obsoleto (advertencia del compilador) en 3.0 SP2
Obsoleto (advertencia del compilador) en 2.0
Obsoleto (advertencia del compilador) en 2.0 SP1
Obsoleto (advertencia del compilador) en 2.0 SP2

.NET Framework Client Profile

Obsoleto (advertencia del compilador) en 4
Obsoleto (advertencia del compilador) en 3.5 SP1

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft