TraceOptions Enumeración

Definición

Espacio de nombres:

System.Diagnostics

Ensamblado:

System.Diagnostics.TraceSource.dll

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

Object

ValueType

Enum

TraceOptions

Atributos

FlagsAttribute

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 Write métodos y WriteLine de las ConsoleTraceListenerclases , DefaultTraceListenery TextWriterTraceListener .

• Los Write métodos y WriteLine de la TraceListener clase cuando no se invalidan en una clase derivada.