Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original
Personas que lo han encontrado útil: 1 de 1 - Valorar este tema

BooleanSwitch (Clase)

Proporciona un modificador activado/desactivado simple que controla la generación de depuración y traza.

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

Espacio de nombres:  System.Diagnostics
Ensamblado:  System (en System.dll)
'Declaración
Public Class BooleanSwitch _
	Inherits Switch

El tipo BooleanSwitch expone los siguientes miembros.

  NombreDescripción
Método públicoBooleanSwitch(String, String)Inicializa una nueva instancia de la clase BooleanSwitch con el nombre para mostrar y la descripción que se hayan especificado.
Método públicoBooleanSwitch(String, String, String)Inicializa una nueva instancia de la clase BooleanSwitch con el nombre para mostrar, la descripción y el valor de modificador predeterminado que se hayan especificado.
Arriba
  NombreDescripción
Propiedad públicaAttributesObtiene los atributos de modificador personalizados definidos en el archivo de configuración de la aplicación. (Se hereda de Switch).
Propiedad públicaDescriptionObtiene una descripción del modificador. (Se hereda de Switch).
Propiedad públicaDisplayNameObtiene el nombre utilizado para identificar el modificador. (Se hereda de Switch).
Propiedad públicaEnabledObtiene o establece un valor que indica si el modificador está habilitado o deshabilitado.
Propiedad protegidaSwitchSettingObtiene o establece la configuración actual de este modificador. (Se hereda de Switch).
Propiedad protegidaValueObtiene o establece el valor del modificador. (Se hereda de Switch).
Arriba
  NombreDescripción
Método públicoEquals(Object)Determina si el objeto especificado es igual al objeto actual. (Se hereda de Object).
Método protegidoFinalize Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object).
Método públicoGetHashCode Sirve como una función hash para un tipo en particular. (Se hereda de Object).
Método protegidoGetSupportedAttributesObtiene los atributos personalizados que admite el modificador. (Se hereda de Switch).
Método públicoGetType Obtiene el Typede la instancia actual. (Se hereda de Object).
Método protegidoMemberwiseClone Crea una copia superficial del Object actual. (Se hereda de Object).
Método protegidoOnSwitchSettingChangedSe invoca cuando cambia la propiedad SwitchSetting. (Se hereda de Switch).
Método protegidoOnValueChangedDetermina si el nuevo valor de la propiedad Value se puede analizar como un valor Boolean. (Invalida a Switch.OnValueChanged).
Método públicoToString Retorna una cadena que representa al objeto actual. (Se hereda de Object).
Arriba

Se puede utilizar un modificador de seguimiento Boolean para habilitar o deshabilitar mensajes según su importancia. Utilice la propiedad Enabled para obtener el valor actual del modificador.

Se puede habilitar o deshabilitar un objeto BooleanSwitch a través del archivo de configuración de la aplicación y, a continuación, utilizar el valor de BooleanSwitch configurado en la aplicación. De modo alternativo, se puede crear un objeto BooleanSwitch en el código y establecer la propiedad Enabled directamente para instrumentar una sección de código específica.

Para configurar BooleanSwitch, modifique el archivo de configuración que corresponde al nombre de la aplicación. En este archivo, puede agregar y quitar un modificador, establecer un valor del modificador o borrar todos los modificadores establecidos previamente por la aplicación. El archivo de configuración debería tener el formato que se muestra en el siguiente ejemplo.

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

En esta sección de configuración de ejemplo se define un objeto BooleanSwitch con la propiedad DisplayName establecida en mySwitch y el valor de Enabled establecido en true. Dentro de la aplicación, puede utilizar el valor del modificador configurado creando un objeto BooleanSwitch con el mismo nombre, tal 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 modo predeterminado, se establece la propiedad Enabled utilizando el valor especificado en el archivo de configuración. Configure el modificador con un valor de 0 para establecer la propiedad Enabled en false; configure el modificador con un valor distinto de cero para establecer la propiedad Enabled en true. Si el constructor BooleanSwitch no puede encontrar los valores iniciales del modificador en el archivo de configuración, la propiedad Enabled del nuevo modificador se establece de modo predeterminado en false.

Para utilizar modificadores, se debe habilitar la traza o la depuración. La sintaxis siguiente es específica del compilador. Si se utilizan compiladores que no sean C# o Visual Basic, consulte la documentación del compilador.

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

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

NotaNota

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

Para obtener más información sobre cómo instrumentar la aplicación, vea Debug y Trace. Para obtener más información acerca de cómo configurar y utilizar modificadores de seguimiento, vea Modificadores de seguimiento.

NotaNota

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

En el siguiente ejemplo se crea un objeto BooleanSwitch y se utiliza el modificador para determinar si se imprimirá un mensaje de error. Se crea el modificador en el nivel de clase. El método Main pasa su posición a MyMethod, que imprime un mensaje de error y el lugar donde se ha producido 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


.NET Framework

Compatible con: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
Todos los miembros públicos static (Shared en Visual Basic) de este tipo son seguros para subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.
¿Te ha resultado útil?
(Caracteres restantes: 1500)
Gracias por sus comentarios

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft. Reservados todos los derechos.