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

Constructor TraceSwitch (String, String)

 

Publicado: octubre de 2016

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

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

public TraceSwitch(
	string displayName,
	string description
)

Parámetros

displayName
Type: System.String

El nombre para mostrar en una interfaz de usuario.

description
Type: System.String

Descripción del modificador.

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

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

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

En la aplicación, puede utilizar el nivel del modificador configurado creando un 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 TraceSwitch constructor no puede encontrar la configuración inicial del modificador en el archivo de configuración del Level propiedad del nuevo modificador se establece en TraceLevel.Off.

La TraceSwitch clase proporciona el TraceError, TraceWarning, TraceInfo, y TraceVerbose Propiedades para probar el Level del conmutador. El Level propiedad obtiene o establece el modificador TraceLevel.

System_CAPS_noteNota

Para mejorar el rendimiento, puede hacer TraceSwitch miembros static en su clase.

En el ejemplo de código siguiente se crea un nuevo TraceSwitch y utiliza el modificador para determinar si se imprimen los mensajes de error. El modificador se crea en el nivel de clase. MyMethod Escribe el primer mensaje de error si el Level propiedad está establecida en TraceLevel.Error o superior. Sin embargo, MyMethod no escribe el segundo mensaje de error si la Level es menor que 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
Disponible desde 1.1
Volver al principio
Mostrar: