TraceOptions Enumeración
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Especifica las opciones de los datos de seguimiento que se van a escribir en el resultado de seguimiento.
Esta enumeración admite una combinación bit a bit de sus valores de miembro.
public enum class TraceOptions[System.Flags]
public enum TraceOptions[<System.Flags>]
type TraceOptions = Public Enum TraceOptions- Herencia
- Atributos
Campos
| Callstack | 32 | Escribe la pila de llamadas, representada por el valor devuelto de la propiedad StackTrace. |
| DateTime | 2 | Escribe la fecha y la hora. |
| LogicalOperationStack | 1 | Escribe la pila de operaciones lógicas, representada por el valor devuelto de la propiedad LogicalOperationStack. |
| None | 0 | No escribe ningún elemento. |
| ProcessId | 8 | Escribe la identidad de proceso, representada por el valor devuelto de la propiedad Id. |
| ThreadId | 16 | Escribe la identidad de subproceso, representada por el valor devuelto de la propiedad ManagedThreadId del subproceso actual. |
| Timestamp | 4 | Escribe la marca de tiempo, representada por el valor devuelto del método GetTimestamp(). |
Ejemplos
En el ejemplo de código siguiente se muestra el uso de la TraceOptions enumeración para establecer mediante programación la TraceOutputOptions propiedad de un agente de escucha de seguimiento de consola. El agente de escucha de seguimiento de la consola es uno de los agentes de escucha enumerados en la Listeners propiedad de un origen de seguimiento. Este ejemplo de código es parte de un ejemplo más grande proporcionado para la clase TraceSource.
ts.Listeners["console"].TraceOutputOptions |= TraceOptions.Callstack;
ts.Listeners("console").TraceOutputOptions = ts.Listeners("console").TraceOutputOptions Or TraceOptions.Callstack
Comentarios
Los agentes de escucha de seguimiento usan esta enumeración para determinar qué opciones o elementos deben incluirse en la salida del seguimiento. Los agentes de escucha de seguimiento almacenan las opciones de seguimiento en la TraceOutputOptions propiedad .
En el ejemplo siguiente se muestra el uso del traceOutputOptions atributo para especificar las opciones de salida de seguimiento de .ConsoleTraceListener El uso de un archivo de configuración como este solo es posible en aplicaciones de .NET Framework.
<configuration>
<system.diagnostics>
<trace autoflush="false" indentsize="4">
<listeners>
<add name="consoleListener"
type="System.Diagnostics.ConsoleTraceListener"
traceOutputOptions="ProcessId, DateTime" />
</listeners>
</trace>
</system.diagnostics>
</configuration>
Para más información sobre cómo agregar agentes de escucha de seguimiento al archivo de configuración de la aplicación, consulte <agentes de> escucha.
La TraceOptions enumeración no se usa en las siguientes clases y métodos:
La EventLogTraceListener clase , porque puede hacer que se escriba un gran volumen de datos en el registro.
Los
Writemétodos yWriteLinede las ConsoleTraceListenerclases , DefaultTraceListenery TextWriterTraceListener .Los Write métodos y WriteLine de la TraceListener clase cuando no se invalidan en una clase derivada.
