Exportar (0) Imprimir
Expandir todo
Este artículo se tradujo de forma manual. Mueva el puntero sobre las frases del artículo para ver el texto original.
Traducción
Original

TraceSwitch (Constructor) (String, String)

Inicializa una nueva instancia de la clase TraceSwitch utilizando el nombre para mostrar y la descripción que se hayan especificado.

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

public TraceSwitch(
	string displayName,
	string description
)

Parámetros

displayName
Tipo: System.String
Nombre que se va a mostrar en una interfaz de usuario.
description
Tipo: System.String
Descripción del modificador.

Para establecer el nivel de TraceSwitch, edite el archivo de configuración correspondiente al nombre de la aplicación. En este archivo, puede agregar un modificador y establecer su valor, quitar el modificador o borrar todos los modificadores establecidos previamente por la aplicación. El archivo de configuración debe tener el mismo formato que en el siguiente ejemplo:

<configuration>
  <system.diagnostics>
    <switches>
      <add name="mySwitch" value="1" />
    </switches>
  </system.diagnostics>
</configuration>
NotaNota

En .NET Framework versión 2.0, puede utilizar texto para especificar el valor de un modificador. Por ejemplo, se puede utilizar true para un modificador BooleanSwitch o el texto que representa un valor de la enumeración, como Error, para un modificador TraceSwitch. La línea <add name="mySwitch" value="Error" /> es equivalente a <add name="mySwitch" value="1" />.

En su aplicación, puede utilizar el nivel del modificador configurado si crea un objeto TraceSwitch con el mismo nombre, como se muestra en el ejemplo siguiente:


private static TraceSwitch appSwitch = new TraceSwitch("mySwitch",
    "Switch in config file");

public static void Main(string[] args)
{
    //...
    Console.WriteLine("Trace switch {0} configured as {1}",
    appSwitch.DisplayName, appSwitch.Level.ToString());
    if (appSwitch.TraceError)
    {
        //...
    }
}


Cuando el constructor TraceSwitch no puede encontrar los valores del modificador iniciales en el archivo de configuración, la propiedad Level del nuevo modificador se establece en TraceLevel.Off.

La clase TraceSwitch proporciona las propiedades TraceError, TraceWarning, TraceInfo y TraceVerbose para probar la propiedad Level del modificador. La propiedad Level obtiene o establece el objeto TraceLevel del modificador.

NotaNota

Para mejorar el rendimiento, puede crear miembros TraceSwitchstatic en la clase.

En el ejemplo de código siguiente se crea un nuevo objeto TraceSwitch y se utiliza el modificador para determinar si se van a imprimir mensajes de error. El modificador se crea en el nivel de clase. MyMethod escribe el primer mensaje de error si la propiedad Level se establece en TraceLevel.Error o superior. Sin embargo, MyMethod no escribe el segundo mensaje de error si Level es inferior a TraceLevel.Verbose.


//Class-level declaration.
 /* Create a TraceSwitch to use in the entire application.*/
 static TraceSwitch mySwitch = new TraceSwitch("General", "Entire Application");

 static public void MyMethod() {
    // Write the message if the TraceSwitch level is set to Error or higher.
    if(mySwitch.TraceError)
       Console.WriteLine("My error message.");

    // Write the message if the TraceSwitch level is set to Verbose.
    if(mySwitch.TraceVerbose)
       Console.WriteLine("My second error message.");
 }

 public static void Main(string[] args) {
    // Run the method that prints error messages based on the switch level.
    MyMethod();
 }
 


.NET Framework

Compatible con: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 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