Exportar (0) Imprimir
Expandir todo

TraceSource (Clase)

Proporciona un conjunto de métodos y propiedades que permiten a las aplicaciones realizar un seguimiento de la ejecución de código y asociar los mensajes de seguimiento a su origen.

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

public ref class TraceSource
public class TraceSource
public class TraceSource
No aplicable.

Las aplicaciones utilizan la clase TraceSource para realizar seguimientos que se pueden asociar a la aplicación. TraceSource proporciona métodos de seguimiento que permiten realizar fácilmente un seguimiento de los eventos y datos, además de emitir seguimientos informativos. Los resultados de seguimiento de TraceSource se pueden controlar mediante el archivo de configuración. Este archivo está ubicado en la carpeta que contiene el ejecutable de la aplicación y tiene el nombre de la aplicación con la extensión .config. Por ejemplo, el nombre del archivo de configuración de TraceSourceSample.exe es TraceSourceSample.exe.config. El archivo de configuración se puede utilizar para determinar adónde se va a enviar la información de seguimiento y de qué niveles de actividad se va a realizar un seguimiento. En el ejemplo siguiente se muestra el contenido de un archivo de configuración de 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 clase TraceSource viene identificada por el nombre de un origen, que suele ser el nombre de la aplicación. Los mensajes de seguimiento procedentes de un componente determinado los puede iniciar un origen de seguimiento específico, lo que permite que todos los mensajes procedentes de ese componente puedan identificarse con facilidad.

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

Para personalizar el destino de los resultados de seguimiento, agregue o quite instancias de TraceListener de la colección almacenada en la propiedad TraceSource.Listeners. De manera predeterminada, los resultados de seguimiento se generan utilizando una instancia de la clase DefaultTraceListener. En el anterior ejemplo de archivo de configuración se muestra cómo quitar el DefaultTraceListener y agregar un ConsoleTraceListener para generar los resultados de seguimiento para el origen de seguimiento. Para obtener más información, vea Elemento <listeners> de <source> y <sharedListeners> (Elemento).

La clase SourceSwitch proporciona los medios para controlar de forma dinámica los resultados de seguimiento. En el anterior ejemplo de archivo de configuración se muestra cómo se puede desactivar el seguimiento de un origen de seguimiento y controlar el nivel en el que se produce el seguimiento. Se puede modificar el valor del modificador de origen sin tener que volver a compilar la aplicación. Para obtener información sobre cómo utilizar el archivo de configuración para establecer un modificador, vea Switch y Cómo: Configurar modificadores de seguimiento.

NotaNota:

Si se modifica un archivo de configuración durante la ejecución de una aplicación, es preciso detener la aplicación e reiniciarla, o bien, llamar al método Refresh para que surta efecto la nueva configuración.

La enumeración TraceEventType se utiliza para definir el tipo de evento del mensaje de seguimiento. Los filtros de seguimiento utilizan 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 al método ShouldTrace en ese filtro para determinar si debe generar la información de seguimiento.

Los agentes de escucha de seguimiento utilizan los valores de las propiedades Indent, IndentSize y AutoFlush de la clase Trace para dar formato a los resultados de seguimiento. Los atributos del archivo de configuración se pueden utilizar para establecer el valor de las propiedades Indent, IndentSize y AutoFlush. En el ejemplo siguiente se establece el valor de la propiedad AutoFlush en false y el valor de la propiedad IndentSize en 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 clase TraceSource para enviar seguimientos a los agentes de escucha. También se muestra el uso de los modificadores y filtros.

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

System.Object
  System.Diagnostics.TraceSource

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.

Windows 98, Windows 2000 Service Pack 4, Windows Millennium, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft