Para ver el artículo en inglés, active la casilla Inglés. También puede ver el texto en inglés en una ventana emergente si pasa el puntero del mouse por el texto.
Traducción
Inglés

Trace Switches

 

Los modificadores de seguimiento permiten habilitar, deshabilitar y filtrar la salida del seguimiento. Son objetos que existen en el código y que se pueden configurar externamente mediante el archivo config. Hay tres tipos de modificadores de seguimiento en .NET Framework: la clase BooleanSwitch, la clase TraceSwitch y la clase SourceSwitch. La propiedad SIDHistory lo hace posible. La propiedad SIDHistory lo hace posible. Si deshabilita el modificador, los mensajes de seguimiento no aparecerán. Todas estas clases derivan de la clase abstracta (MustInherit) Switch, igual que deberían todos los modificadores desarrollados por el usuario.

Los modificadores de seguimiento pueden ser útiles para filtrar información. Por ejemplo, quizás quiera ver todos los mensajes de seguimiento de un módulo de acceso a datos, pero solo los mensajes de error del resto de la aplicación. En ese caso, usaría un modificador de seguimiento para el módulo de acceso a datos y otro para el resto de la aplicación. Se puede usar el archivo .config para configurar las opciones apropiadas de los modificadores con el fin de controlar qué tipos de mensajes de seguimiento recibe. Para obtener más información, véase Novedades en el SDK Visual Studio 2015.

Normalmente, una aplicación implementada se ejecuta con sus modificadores deshabilitados para que los usuarios no tengan que ver numerosos mensajes de seguimiento irrelevantes en la pantalla o que el archivo de registro se llene durante la ejecución de la aplicación. Si surge un problema durante la ejecución de la aplicación, puede detener la aplicación, habilitar los modificadores y reiniciar la aplicación. Después, se mostrarán los mensajes de seguimiento.

Para usar un modificador primero debe crear un objeto modificador a partir de una clase BooleanSwitch, una clase TraceSwitch o una clase de modificador definida por el desarrollador. Para más información sobre cómo crear modificadores definidos por el desarrollador, consulte la clase Switch en la referencia de .NET Framework. Después, establezca un valor de configuración que especifique cuándo se va a usar el objeto modificador. A continuación, pruebe el valor del objeto modificador en varios métodos de seguimiento Trace (o Debug).

Al usar TraceSwitch hay que tener en cuenta algunas consideraciones adicionales. Un objeto TraceSwitch tiene cuatro propiedades que devuelven valores Boolean que indican si el modificador está establecido al menos en un nivel determinado:

Los niveles permiten limitar la cantidad de información de seguimiento para recibir solo la información necesaria para solucionar un problema. Configure los modificadores de seguimiento en el nivel de seguimiento adecuado para especificar el nivel de detalle que quiere en la salida del seguimiento. Puede recibir mensajes de error, mensajes de advertencia, mensajes informativos, mensajes de seguimiento detallados o ningún mensaje.

Está en sus manos decidir qué tipo de mensaje asociará a cada nivel. Normalmente, el contenido de los mensajes de seguimiento depende de lo que asocie a cada nivel, pero usted determina las diferencias entre los niveles. Desea proporcionar descripciones detalladas de un problema en el nivel 3 (Info), por ejemplo, pero solo un número de referencia de error en el nivel 1 (Error). Es decisión suya qué esquema funciona mejor en su aplicación.

Estas propiedades corresponden a los valores 1 a 4 de la enumeración TraceLevel. En la tabla siguiente se enumeran los niveles de la enumeración TraceLevel y sus valores.

Valor enumerado

Valor entero

Tipo de mensaje que se muestra (o se escribe en un destino de salida especificado)

Desactivado

0

NONE

Error

1

Solo mensajes de error

Advertencia

2

Mensajes de advertencia y mensajes de error

Información

3

Mensajes informativos, mensajes de advertencia y mensajes de error

Detallado

4

Mensajes detallados, mensajes informativos, mensajes de advertencia y mensajes de error

Las propiedades de TraceSwitch indican el nivel de seguimiento máximo para el modificador. Es decir, la información de seguimiento se escribe para el nivel especificado y para todos los niveles inferiores. Por ejemplo, si TraceInfo es true, TraceError y TraceWarning también son true, pero TraceVerbose podría ser false.

Estas propiedades son de solo lectura. La propiedad SIDHistory lo hace posible. Por ejemplo:

System.Diagnostics.TraceSwitch myTraceSwitch = new System.Diagnostics.TraceSwitch("SwitchOne", "The first switch"); myTraceSwitch.Level = System.Diagnostics.TraceLevel.Info; // This message box displays true, because setting the level to // TraceLevel.Info sets all lower levels to true as well. MessageBox.Show(myTraceSwitch.TraceWarning.ToString()); // This message box displays false. MessageBox.Show(myTraceSwitch.TraceVerbose.ToString());

Además de proporcionar BooleanSwitch y TraceSwitch, puede definir sus propios modificadores heredando de la clase Switch y reemplazando los métodos de la clase base por métodos personalizados. Para más información sobre cómo crear modificadores definidos por el desarrollador, consulte la clase Switch en la referencia de .NET Framework.

Mostrar: