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

BooleanSwitch (Clase)

 

Proporciona un conmutador de activado/desactivado sencillo que controla los resultados de depuración y traza.

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

System.Object
  System.Diagnostics.Switch
    System.Diagnostics.BooleanSwitch

Public Class BooleanSwitch
	Inherits Switch

NombreDescripción
System_CAPS_pubmethodBooleanSwitch(String, String)

Inicializa una nueva instancia de la clase BooleanSwitch con el nombre para mostrar especificado y la descripción.

System_CAPS_pubmethodBooleanSwitch(String, String, String)

Inicializa una nueva instancia de la clase BooleanSwitch con el nombre para mostrar especificado, la descripción y el valor de modificador predeterminado.

NombreDescripción
System_CAPS_pubpropertyAttributes

Obtiene los atributos de modificador personalizados definidos en el archivo de configuración de la aplicación.(Heredado de Switch.)

System_CAPS_pubpropertyDescription

Obtiene una descripción del modificador.(Heredado de Switch.)

System_CAPS_pubpropertyDisplayName

Obtiene el nombre utilizado para identificar el modificador.(Heredado de Switch.)

System_CAPS_pubpropertyEnabled

Obtiene o establece un valor que indica si el modificador está habilitado o deshabilitado.

System_CAPS_protpropertySwitchSetting

Obtiene o establece el valor actual de este modificador.(Heredado de Switch.)

System_CAPS_protpropertyValue

Obtiene o establece el valor del modificador.(Heredado de Switch.)

NombreDescripción
System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object.)

System_CAPS_protmethodFinalize()

Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por el recolector de basura. (Heredado de Object.)

System_CAPS_pubmethodGetHashCode()

Sirve como la función hash predeterminada.(Heredado de Object.)

System_CAPS_protmethodGetSupportedAttributes()

Obtiene los atributos personalizados admitidos por el modificador.(Heredado de Switch.)

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object.)

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficial del Object actual.(Heredado de Object.)

System_CAPS_protmethodOnSwitchSettingChanged()

Cuando invoca el SwitchSetting se cambia la propiedad.(Heredado de Switch.)

System_CAPS_protmethodOnValueChanged()

Determina si el nuevo valor de la propiedad Value se puede analizar como un valor booleano.(Reemplaza a Switch.OnValueChanged()).

System_CAPS_pubmethodToString()

Retorna una cadena que representa al objeto actual. (Heredado de Object.)

Puede utilizar un modificador de seguimiento Boolean para habilitar o deshabilitar mensajes según su importancia. Utilice la Enabled propiedad que se va a obtener el valor actual del conmutador.

Puede habilitar o deshabilitar un BooleanSwitch a través del archivo de configuración de aplicación y a continuación, utilice el BooleanSwitch valor de la aplicación. Como alternativa, puede crear un BooleanSwitch en el código y establezca la Enabled propiedad directamente para instrumentar una sección de código específica.

Para configurar un BooleanSwitch, edite el archivo de configuración que corresponde al nombre de la aplicación. En este archivo, puede agregar o quitar un modificador, establecer un valor del modificador o borrar todos los modificadores establecidos previamente por la aplicación. El archivo de configuración se debe dar formato como en el ejemplo siguiente.

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

Esta sección de configuración de ejemplo se define un BooleanSwitch con el DisplayName propiedad establecida en mySwitch y Enabled el valor true. Dentro de la aplicación, puede utilizar el valor del modificador configurado creando un BooleanSwitch con el mismo nombre, como se muestra en el ejemplo de código siguiente.

Private Shared boolSwitch As new BooleanSwitch("mySwitch", _
    "Switch in config file")

Public Shared Sub Main( )
    '...
    Console.WriteLine("Boolean switch {0} configured as {1}",
        boolSwitch.DisplayName, boolSwitch.Enabled.ToString())
    If boolSwitch.Enabled = True Then
        '...
    End If
End Sub

De forma predeterminada, la Enabled propiedad se establece utilizando el valor especificado en el archivo de configuración. Configure el modificador con un valor de 0 para establecer el Enabled propiedad false; configure el modificador con un valor distinto de cero para establecer el Enabled propiedad true. Si el BooleanSwitch constructor no puede encontrar la configuración inicial del modificador en el archivo de configuración del Enabled propiedad del nuevo modificador se establece en false de forma predeterminada.

Debe habilitar el seguimiento o la depuración para utilizar un modificador. La sintaxis siguiente es específica del compilador. Si utiliza compiladores distintos de C# o Visual Basic, consulte la documentación del compilador.

  • Para habilitar la depuración en C#, agregue el /d:DEBUG marca a la línea de comandos del compilador al compilar el código o puede agregar #define DEBUG a la parte superior del archivo. En Visual Basic, agregue el /d:DEBUG=True marca a la línea de comandos del compilador.

  • Para habilitar el seguimiento en C#, agregue el /d:TRACE marca a la línea de comandos del compilador al compilar el código, o agregue #define TRACE a la parte superior del archivo. En Visual Basic, agregue el /d:TRACE=True marca a la línea de comandos del compilador.

System_CAPS_noteNota

Estos de depuración y los modificadores de compilador de seguimiento no son necesarios cuando se utiliza la BooleanSwitch clase de forma aislada. Sólo necesitan junto con Trace o Debug métodos que se compilan condicionalmente.

Para obtener más información sobre cómo instrumentar la aplicación, consulte Debug y Trace. Para obtener más información acerca de cómo configurar y usar los modificadores de seguimiento, consulte Trace Switches.

System_CAPS_noteNota

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

En el ejemplo siguiente se crea un BooleanSwitch y utiliza el modificador para determinar si se imprime un mensaje de error. Cree el conmutador en el nivel de clase. El Main método pasa su ubicación a MyMethod, que imprime un mensaje de error y dónde se produjo el error.

' Class level declaration.
' Create a BooleanSwitch for data. 
Private Shared dataSwitch As New BooleanSwitch("Data", "DataAccess module")


Public Shared Sub MyMethod(location As String)
    ' Insert code here to handle processing.
    If dataSwitch.Enabled Then
        Console.WriteLine(("Error happened at " + location))
    End If
End Sub 'MyMethod

' Entry point which delegates to C-style main function.
Public Overloads Shared Sub Main()
    Main(System.Environment.GetCommandLineArgs())
End Sub

Overloads Public Shared Sub Main(args() As String)
    ' Run the method which writes an error message specifying the location of the error.
    MyMethod("in Main")
End Sub 'Main

Universal Windows Platform
Disponible desde 10
.NET Framework
Disponible desde 1.1

Los miembros estáticos públicos (Shared en Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Volver al principio
Mostrar: