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

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

NOTA: este método ya está obsoleto.

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
)
/** @attribute 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
)
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 function Create (
	categoryName : String, 
	categoryHelp : String, 
	counterData : CounterCreationDataCollection
) : 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.

counterData

CounterCreationDataCollection que especifica los contadores que se van a crear como parte de la nueva categoría.

Valor devuelto

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

Tipo de excepciónCondición

ArgumentException

Un nombre de contador especificado dentro de la colección counterData es referencia de objeto null (Nothing en Visual Basic) 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 referencia de objeto null (Nothing en Visual Basic).

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.

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",ccds);           
}

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

    CounterCreationData milkPerSecond = new CounterCreationData();
    milkPerSecond.set_CounterName("milk orders/second");
    milkPerSecond.set_CounterType(PerformanceCounterType.
        RateOfCountsPerSecond32);
    CounterCreationDataCollection ccds = 
        new CounterCreationDataCollection();
    ccds.Add(milkPerSecond);
    ccds.Add(milk);

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

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: 1.0, 1.1
Obsoleto (advertencia del compilador) en 2.0

Adiciones de comunidad

AGREGAR
Mostrar:
© 2016 Microsoft