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

TraceSwitch.Level (Propiedad)

Actualización: noviembre 2007

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

Tipo: System.Diagnostics.TraceLevel
Uno de los valores de TraceLevel que especifica el nivel de mensajes que permite el modificador.

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>
834xk63s.alert_note(es-es,VS.90).gifNota:

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" />.

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("mySwitch", "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("mySwitch", "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 Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

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