Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

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.

System.Object
  System.Diagnostics.TraceSource

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

type TraceSource =  class end

El tipo TraceSource expone los siguientes miembros.

  NombreDescripción
Método públicoTraceSource(String)Inicializa una nueva instancia de la clase TraceSource utilizando el nombre especificado del origen.
Método públicoTraceSource(String, SourceLevels)Inicializa una nueva instancia de la clase TraceSource, utilizando el nombre especificado del origen y el nivel de origen predeterminado en el que se va a producir la traza.
Arriba

  NombreDescripción
Propiedad públicaAttributesObtiene los atributos de modificador personalizados definidos en el archivo de configuración de la aplicación.
Propiedad públicaListenersObtiene la colección de agentes de escucha de seguimiento para el origen de seguimiento.
Propiedad públicaNameObtiene el nombre del origen de seguimiento.
Propiedad públicaSwitchObtiene o establece el valor del modificador de origen.
Arriba

  NombreDescripción
Método públicoCloseCierra todos los agentes de escucha de seguimiento en la colección de agentes de escucha de seguimiento.
Método públicoEquals(Object)Determina si el objeto especificado es igual al objeto actual. (Se hereda de Object).
Método protegidoFinalize Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object).
Método públicoFlushVacía todos los agentes de escucha de seguimiento en la colección de agentes de escucha de seguimiento.
Método públicoGetHashCode Sirve como una función hash para un tipo en particular. (Se hereda de Object).
Método protegidoGetSupportedAttributesObtiene los atributos personalizados admitidos por el origen de seguimiento.
Método públicoGetType Obtiene el Type de la instancia actual. (Se hereda de Object).
Método protegidoMemberwiseClone Crea una copia superficial del Object actual. (Se hereda de Object).
Método públicoToString Retorna una cadena que representa al objeto actual. (Se hereda de Object).
Método públicoTraceData(TraceEventType, Int32, Object)Escribe la información de seguimiento en los agentes de escucha de seguimiento de la colección Listeners utilizando el tipo de evento, el identificador de evento y la información de seguimiento especificados.
Método públicoTraceData(TraceEventType, Int32, Object[])Escribe la información de seguimiento en los agentes de escucha de seguimiento de la colección Listeners utilizando el tipo de evento, el identificador de evento y la matriz de datos de seguimiento especificados.
Método públicoTraceEvent(TraceEventType, Int32)Escribe un mensaje de un evento de seguimiento en los agentes de escucha de seguimiento de la colección Listeners utilizando el tipo de evento y el identificador de evento especificados.
Método públicoTraceEvent(TraceEventType, Int32, String)Escribe un mensaje de un evento de seguimiento en los agentes de escucha de seguimiento de la colección Listeners utilizando el tipo de evento, el identificador de evento y el mensaje especificados.
Método públicoTraceEvent(TraceEventType, Int32, String, Object[])Escribe un evento de seguimiento en los agentes de escucha de seguimiento de la colección Listeners utilizando el tipo de evento, el identificador de evento, la matriz de argumentos y el formato especificados.
Método públicoTraceInformation(String)Escribe un mensaje informativo en los agentes de escucha de seguimiento de la colección Listeners mediante el mensaje especificado.
Método públicoTraceInformation(String, Object[])Escribe un mensaje informativo en los agentes de escucha de seguimiento de la colección Listeners utilizando la matriz de objetos y la información de formato especificadas.
Método públicoTraceTransferEscribe un mensaje de transferencia de traza en los agentes de escucha de traza de la colección Listeners utilizando el identificador numérico especificado, el mensaje y el identificador de la actividad relacionada.
Arriba

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. Los resultados de traza 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 para TraceSourceSample.exe es TraceSourceSample.exe.config. El archivo de configuración se puede utilizar para determinar donde será enviada la información de seguimiento y qué niveles de actividad serán seguidos paso a paso. 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 traza pero, en realidad, no proporciona ningún mecanismo concreto para generar y almacenar los datos de traza. Los datos de traza los generan los agentes de escucha de traza, que son complementos que pueden cargar los orígenes de traza.

NotaNota

No se debe llamar a los métodos de traza durante la finalización. Esta acción puede hacer que se produzca una excepción ObjectDisposedException.

Para personalizar el destino de los resultados de traza, 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).

NotaNota

Al agregar un agente de escucha de seguimiento a la colección Listeners se puede originar una excepción que se producirá mientras tiene lugar la traza, si el recurso utilizado por el agente de escucha de traza no está disponible. Las condiciones y la excepción producidas dependen del agente de escucha de seguimiento y no se pueden enumerar en este tema. Puede ser útil para llamar a los métodos TraceSource en bloques try/catch para detectar y administrar cualquier excepción de los agentes de escucha de seguimiento.

La clase SourceSwitch proporciona los medios para controlar de forma dinámica los resultados de traza. En el anterior ejemplo de archivo de configuración se muestra cómo se puede desactivar la traza de un origen de traza y controlar el nivel en el que se produce la traza. 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.

.NET Framework

Compatible con: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

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

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft