Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase TraceSource

 

Publicado: julio de 2016

Proporciona un conjunto de métodos y propiedades que permiten que las aplicaciones realicen un seguimiento de la ejecución de código y asocien mensajes de seguimiento con su origen.

Espacio de nombres:   System.Diagnostics
Ensamblado:  System (en System.dll)

System.Object
  System.Diagnostics.TraceSource

type TraceSource = class end

NombreDescripción
System_CAPS_pubmethodTraceSource(String)

Inicializa una instancia nueva de la clase TraceSource usando el nombre especificado para el origen.

System_CAPS_pubmethodTraceSource(String, SourceLevels)

Inicializa una nueva instancia de la clase TraceSource con el nombre especificado para el origen y el nivel de origen predeterminado en el que se producirá el seguimiento.

NombreDescripción
System_CAPS_pubpropertyAttributes

Obtiene los atributos de modificador personalizados definidos en el archivo de configuración de la aplicación.

System_CAPS_pubpropertyListeners

Obtiene la colección de agentes de escucha de seguimiento para el origen de seguimiento.

System_CAPS_pubpropertyName

Obtiene el nombre del origen de seguimiento.

System_CAPS_pubpropertySwitch

Obtiene o establece el valor del modificador de origen.

NombreDescripción
System_CAPS_pubmethodClose()

Cierra todos los agentes de escucha de seguimiento en la colección de agentes de escucha de seguimiento.

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_pubmethodFlush()

Vacía todos los agentes de escucha de seguimiento en la colección de agentes de escucha de seguimiento.

System_CAPS_pubmethodGetHashCode()

Sirve como la función hash predeterminada.(Heredado de Object).

System_CAPS_protmethodGetSupportedAttributes()

Obtiene los atributos personalizados admitidos por el origen de seguimiento.

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_pubmethodToString()

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

System_CAPS_pubmethodTraceData(TraceEventType, Int32, Object)

Escribe datos de seguimiento en los agentes de escucha de seguimiento de la colección Listeners con el tipo de evento, el identificador de evento y los datos de seguimiento especificados.

System_CAPS_pubmethodTraceData(TraceEventType, Int32, Object[])

Escribe datos de seguimiento en los agentes de escucha de seguimiento de la colección Listeners con el tipo de evento, el identificador de evento y la matriz de datos de seguimiento especificados.

System_CAPS_pubmethodTraceEvent(TraceEventType, Int32)

Escribe un mensaje de evento de seguimiento en los agentes de escucha de seguimiento de la colección Listeners con el tipo de evento y el identificador de evento especificados.

System_CAPS_pubmethodTraceEvent(TraceEventType, Int32, String)

Escribe un mensaje de evento de seguimiento en los agentes de escucha de seguimiento de la colección Listeners con el tipo de evento, el identificador de evento y el mensaje especificados.

System_CAPS_pubmethodTraceEvent(TraceEventType, Int32, String, Object[])

Escribe un evento de seguimiento en los agentes de escucha de seguimiento de la colección Listeners con el tipo de evento, el identificador de evento y el formato y la matriz de argumentos especificados.

System_CAPS_pubmethodTraceInformation(String)

Escribe un mensaje informativo en los agentes de escucha de seguimiento de la colección Listeners con el mensaje especificado.

System_CAPS_pubmethodTraceInformation(String, Object[])

Escribe un mensaje informativo en los agentes de escucha de seguimiento de la colección Listeners con la matriz de objetos y la información de formato especificadas.

System_CAPS_pubmethodTraceTransfer(Int32, String, Guid)

Escribe un mensaje de transferencia de seguimiento en los agentes de escucha de seguimiento de la colección Listeners con el identificador numérico, el mensaje y el identificador de actividad relacionado especificados.

Las aplicaciones utilizan la clase TraceSource para generar seguimientos que pueden asociarse con la aplicación. TraceSource proporciona métodos de traza que permiten rastrear fácilmente eventos y datos, así como emitir seguimientos de información. Resultado del seguimiento de TraceSource puede controlarse mediante el archivo de configuración. El archivo de configuración se encuentra en la carpeta que contiene el ejecutable de la aplicación y tiene el nombre de la aplicación con la extensión de nombre de archivo .config agregada. Por ejemplo, el nombre del archivo de configuración para TraceSourceSample.exe es TraceSourceSample.exe.config. El archivo de configuración se puede utilizar para determinar dónde la información de seguimiento se envían y sean qué niveles de actividad para realizar un seguimiento. En el ejemplo siguiente se muestra el contenido de un archivo de configuración de la aplicación de ejemplo.

<configuration>
  <system.diagnostics>
    <sources>
      <source name="TraceTest" switchName="SourceSwitch" 
        switchType="System.Diagnostics.SourceSwitch" >
        <listeners>
          <add name="console" />
          <remove name ="Default" />
        </listeners>
      </source>
    </sources>
    <switches>
      <!-- You can set the level at which tracing is to occur -->
      <add name="SourceSwitch" value="Warning" />
        <!-- You can turn tracing off -->
        <!--add name="SourceSwitch" value="Off" -->
    </switches>
    <sharedListeners>
      <add name="console" 
        type="System.Diagnostics.ConsoleTraceListener" 
        initializeData="false"/>
    </sharedListeners>
    <trace autoflush="true" indentsize="4">
      <listeners>
        <add name="console" />
      </listeners>
    </trace>
  </system.diagnostics>
</configuration>

La TraceSource clase identificada por el nombre de un origen, normalmente es el nombre de la aplicación. Los mensajes de seguimiento procedentes de un componente determinado se pueden iniciar por un origen de seguimiento específico, lo que todos los mensajes procedentes de ese componente se identifican fácilmente.

TraceSource define los métodos de traza pero realmente no proporciona ningún mecanismo concreto para generar y almacenar los datos de seguimiento. Los datos de seguimiento generados por los agentes de escucha de seguimiento, que son complementos que pueden cargar los orígenes de seguimiento.

System_CAPS_noteNota

No debe llamar a los métodos de traza durante la finalización. Esto puede provocar una ObjectDisposedException producida.

Puede personalizar el destino de los resultados de la traza agregando o quitando TraceListener instancias de la colección almacenada en la TraceSource.Listeners propiedad. De forma predeterminada, los resultados de seguimiento se generan mediante una instancia de la DefaultTraceListener clase. El anterior ejemplo de archivo de configuración muestra cómo quitar el DefaultTraceListener y agregando un ConsoleTraceListener para generar el resultado de seguimiento para el origen de seguimiento. Para obtener más información, consulte Elemento <listeners> de <source> y <sharedListeners> (Elemento).

System_CAPS_noteNota

Agregar un agente de escucha de seguimiento para el Listeners colección puede producir una excepción que se produzca durante el seguimiento, si un recurso utilizado por el agente de escucha de seguimiento no está disponible. Las condiciones y la excepción dependen de la escucha de seguimiento y no se pueden enumerar en este tema. Puede ser útil realizar llamadas a la TraceSource métodos en try/catch bloques para detectar y controlar las excepciones de los agentes de escucha de seguimiento.

La SourceSwitch clase proporciona los medios para controlar de forma dinámica los resultados del seguimiento. El ejemplo de archivo de configuración anterior muestra cómo se puede desactivar el seguimiento de un origen de seguimiento y controlar el nivel en que el seguimiento se produce. Puede modificar el valor del modificador de origen sin volver a compilar la aplicación. Para obtener información acerca de cómo utilizar el archivo de configuración para establecer un modificador, consulte Switch y How to: Create, Initialize and Configure Trace Switches.

System_CAPS_noteNota

Si modifica un archivo de configuración mientras se ejecuta una aplicación, debe detener y reiniciar la aplicación o el Refresh método debe llamarse antes de que la nueva configuración surta efecto.

El TraceEventType enumeración se utiliza para definir el tipo de evento de mensaje de seguimiento. Uso de filtros de seguimiento el TraceEventType para determinar si un agente de escucha de seguimiento debe generar el mensaje de seguimiento.

Los agentes de escucha de seguimiento pueden tener opcionalmente una capa adicional de filtrado a través de un filtro de seguimiento. Si un agente de escucha de seguimiento tiene un filtro asociado, el agente de escucha llama el ShouldTrace método en ese filtro para determinar si se debe o no generar la información de seguimiento.

Los agentes de escucha de seguimiento utilizan los valores de la Trace Propiedades de la clase Indent, IndentSize, y AutoFlush a los resultados de seguimiento de formato. Puede utilizar los atributos de archivo de configuración para establecer el Indent, IndentSize, y AutoFlush Propiedades. El ejemplo siguiente establece el AutoFlush propiedad false y el IndentSize propiedad a 3.

<configuration>
  <system.diagnostics>
    <trace autoflush="false" indentsize="3" />
  </system.diagnostics>
</configuration>

En el ejemplo de código siguiente se muestra el uso de la TraceSource clase para enviar seguimientos a los agentes de escucha. El ejemplo también muestra el uso de modificadores y filtros.

No hay ningún ejemplo de código disponible o este idioma no es compatible.

.NET Framework
Disponible desde 2.0

Este tipo es seguro para la ejecución de subprocesos.

Volver al principio
Mostrar: