Esta documentación está archivada y no tiene mantenimiento.

TraceSwitch.Level (Propiedad)

Obtiene o establece el nivel de seguimiento que determina los mensajes que permite el modificador.

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

public TraceLevel Level { get; set; }
/** @property */
public TraceLevel get_Level ()

/** @property */
public void set_Level (TraceLevel value)

public function get Level () : TraceLevel

public function set Level (value : TraceLevel)

Valor de propiedad

Uno de los valores de TraceLevel que especifica el nivel de mensajes que admite el modificador.

Tipo de excepciónCondición

ArgumentException

La propiedad Level está establecida en un valor que no es uno de los valores de TraceLevel.

Para establecer el nivel de TraceSwitch, modifique 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="0" />
      <add name="myNewSwitch" value="3" />
      <remove name="mySwitch" />
      <clear/>
    </switches>
  </system.diagnostics>
</configuration>

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.

Al establecer esta propiedad se actualizan las propiedades TraceError, TraceWarning, TraceInfo y TraceVerbose para reflejar el nuevo valor.

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 escribirá el primer mensaje de error si 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();
 }


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

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

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

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

Windows 98, Windows 2000 SP4, Windows Millennium, 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: 2.0, 1.1, 1.0
Mostrar: