Exportar (0) Imprimir
Expandir todo

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

NOTA: este método ya está obsoleto.

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")] 
public static PerformanceCounterCategory Create (
	string categoryName,
	string categoryHelp,
	string counterName,
	string counterHelp
)
/** @attribute 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") */ 
public static PerformanceCounterCategory Create (
	String categoryName, 
	String categoryHelp, 
	String counterName, 
	String counterHelp
)
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") 
public static function Create (
	categoryName : String, 
	categoryHelp : String, 
	counterName : String, 
	counterHelp : String
) : PerformanceCounterCategory
No aplicable.

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.

counterName

Nombre de un nuevo contador de tipo NumberOfItems32 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 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

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

O bien

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

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 contadores de rendimiento, debe tener privilegios administrativos. En Windows Vista, 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 crean una PerformanceCounterCategory y un solo PerformanceCounter con texto de ayuda para cada uno, mediante el método Create(String,String,String,String).

public static void Main(string[] args)
{
    string categoryName = "";
    string counterName = "";
    string categoryHelp = "";
    string counterHelp = "";
    PerformanceCounterCategory pcc;

    // Copy the supplied arguments into the local variables.
    try
    {
        categoryName = args[0];
        counterName = args[1];
        categoryHelp = args[2];
        counterHelp = args[3];
    }
    catch(Exception ex)
    {
        // Ignore the exception from non-supplied arguments.
    }

    Console.WriteLine("Category name: \"{0}\"", categoryName);
    Console.WriteLine("Category help: \"{0}\"", categoryHelp);
    Console.WriteLine("Counter name:  \"{0}\"", counterName);
    Console.WriteLine("Counter help:  \"{0}\"", counterHelp);

    // Use the Create overload that creates a single counter.
    try
    {
        pcc = PerformanceCounterCategory.Create(categoryName, categoryHelp, counterName, counterHelp);
        Console.WriteLine("Category \"{0}\" created.", pcc.CategoryName);

    }
    catch(Exception ex)
    {
        Console.WriteLine("Unable to create the above category and counter:" + "\n" + ex.Message);
    }
}

Windows 98, Windows 2000 Service Pack 4, Windows Millennium, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 1.0, 1.1, 2.0
Obsoleto (advertencia del compilador) en 3.0

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft