BooleanSwitch Clase
TOC
Collapse the table of content
Expand the table of content
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

BooleanSwitch (Clase)

 

Proporciona un modificador activado/desactivado simple que controla la generación 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 : Switch

NombreDescripción
System_CAPS_pubmethodBooleanSwitch(String, String)

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

System_CAPS_pubmethodBooleanSwitch(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.

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 la configuración 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 una función hash para un tipo en particular. (Heredado de Object.)

System_CAPS_protmethodGetSupportedAttributes()

Obtiene los atributos personalizados que admite 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()

Se invoca cuando cambia la propiedad SwitchSetting.(Heredado de Switch.)

System_CAPS_protmethodOnValueChanged()

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

System_CAPS_pubmethodToString()

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

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 static BooleanSwitch boolSwitch = new BooleanSwitch("mySwitch",
    "Switch in config file");

public static void Main( )
{
    //...
    Console.WriteLine("Boolean switch {0} configured as {1}",
        boolSwitch.DisplayName, boolSwitch.Enabled.ToString());
    if (boolSwitch.Enabled)
    {
        //...
    }
}

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.

System_CAPS_noteNota

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.

System_CAPS_noteNota

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.*/
static BooleanSwitch dataSwitch = new BooleanSwitch("Data", "DataAccess module");

static public void MyMethod(string location) {
   //Insert code here to handle processing.
   if(dataSwitch.Enabled)
      Console.WriteLine("Error happened at " + location);
}

public static void Main(string[] args) {
   //Run the method which writes an error message specifying the location of the error.
   MyMethod("in Main");
}

.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:
© 2016 Microsoft