TraceSwitch Constructores

Definición

Espacio de nombres:

System.Diagnostics

Ensamblado:

System.Diagnostics.TraceSource.dll

Inicializa una nueva instancia de la clase TraceSwitch.

Sobrecargas

TraceSwitch(String, String)	Inicializa una nueva instancia de la clase TraceSwitch utilizando el nombre para mostrar y la descripción que se hayan especificado.
TraceSwitch(String, String, String)	Inicializa una nueva instancia de la clase TraceSwitch utilizando el nombre para mostrar, la descripción y el valor predeterminado del modificador que se hayan especificado.

TraceSwitch(String, String)

Source:

TraceSwitch.cs

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

public:
 TraceSwitch(System::String ^ displayName, System::String ^ description);

public TraceSwitch (string displayName, string? description);

new System.Diagnostics.TraceSwitch : string * string -> System.Diagnostics.TraceSwitch

Public Sub New (displayName As String, description As String)

Parámetros

displayName

String

El nombre para mostrar en una interfaz de usuario.

description

String

Descripción del modificador.

Ejemplos

En el ejemplo de código siguiente se crea un nuevo TraceSwitch y se usa el modificador para determinar si se deben imprimir mensajes de error. El modificador se crea en el nivel de clase. MyMethod escribe el primer mensaje de error si la Level propiedad está establecida TraceLevel.Error en o superior. Sin embargo, MyMethod no escribe el segundo mensaje de error si Level es menor que TraceLevel.Verbose.

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

public:
   static 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." );
   }

   static void main()
   {
      // 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.*/
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 Shared mySwitch As New TraceSwitch("General", "Entire Application")    

Public Shared Sub MyMethod()
    ' Write the message if the TraceSwitch level is set to Error or higher.
    If mySwitch.TraceError Then
        Console.WriteLine("My error message.")
    End If 
    ' Write the message if the TraceSwitch level is set to Verbose.
    If mySwitch.TraceVerbose Then
        Console.WriteLine("My second error message.")
    End If
End Sub

Public Shared Sub Main()
    ' Run the method that prints error messages based on the switch level.
    MyMethod()
End Sub

Comentarios

Para las aplicaciones de .NET Framework, para establecer el nivel de , TraceSwitchedite 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 anteriormente por la aplicación. El archivo de configuración debe tener formato similar al ejemplo siguiente:

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

También puede usar texto para especificar el valor de un modificador. Por ejemplo, true para un BooleanSwitch objeto o el texto que representa un valor de enumeración, como Error para .TraceSwitch La línea <add name="mySwitch" value="Error" /> es equivalente a <add name="mySwitch" value="1" />.

En la aplicación, puede usar el nivel de conmutador configurado mediante la creación de un TraceSwitch con el mismo nombre, como se muestra en el ejemplo siguiente:

private:
    static TraceSwitch^ appSwitch = gcnew TraceSwitch("mySwitch",
        "Switch in config file");

public:
    static void Main(array<String^>^ args)
    {
        //...
        Console::WriteLine("Trace switch {0} configured as {1}",
        appSwitch->DisplayName, appSwitch->Level.ToString());
        if (appSwitch->TraceError)
        {
            //...
        }
    }

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)
    {
        //...
    }
}

Private Shared appSwitch As new TraceSwitch("mySwitch", _
    "Switch in config file")

Public Shared Sub Main(args As String())
    '...
    Console.WriteLine("Trace switch {0} configured as {1}",
    appSwitch.DisplayName, appSwitch.Level.ToString())
    If appSwitch.TraceError = True  Then
        '...
    End If
End Sub

Este constructor establece la Level propiedad del nuevo modificador en TraceLevel.Off. O bien, para las aplicaciones de .NET Framework, la configuración del modificador se obtiene del archivo de configuración, si está disponible.

La TraceSwitch clase proporciona las TraceErrorpropiedades , TraceWarning, TraceInfoy TraceVerbose para probar el Level del modificador. La Level propiedad obtiene o establece el modificador TraceLevel.

Nota

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

Consulte también

• TraceSwitch
• TraceLevel
• Switch
• Debug
• Trace

TraceSwitch(String, String, String)

Source:

TraceSwitch.cs

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

public:
 TraceSwitch(System::String ^ displayName, System::String ^ description, System::String ^ defaultSwitchValue);

public TraceSwitch (string displayName, string? description, string defaultSwitchValue);

new System.Diagnostics.TraceSwitch : string * string * string -> System.Diagnostics.TraceSwitch

Public Sub New (displayName As String, description As String, defaultSwitchValue As String)

Parámetros

displayName

String

El nombre para mostrar en una interfaz de usuario.

description

String

Descripción del modificador.

defaultSwitchValue

String

Valor predeterminado del modificador.

Comentarios

El displayName parámetro se usa para establecer el valor de la DisplayName propiedad , el description parámetro se usa para establecer el valor de la Description propiedad y el defaultSwitchValue parámetro se guarda como un campo y se usa para inicializar la Value propiedad en la primera referencia. Consulte el TraceSwitch(String, String) constructor para obtener más información y un ejemplo de código.