¿Le resultó útil esta página?
Sus comentarios sobre este contenido son muy importantes. Háganos saber su opinión.
¿Tiene comentarios adicionales?
Caracteres restantes: 1500
TraceSource (Clase)
Collapse the table of content
Expand the table of content
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 que las aplicaciones realicen un seguimiento de la ejecución de código y asocien mensajes de seguimiento con su origen.

System.Object
  System.Diagnostics.TraceSource

Espacio de nombres:  System.Diagnostics
Ensamblados:   System (en System.dll)
  System.Diagnostics.TraceSource (en System.Diagnostics.TraceSource.dll)

type TraceSource =  class end

El tipo TraceSource expone los siguientes miembros.

  NombreDescripción
Método públicoTraceSource(String)Inicializa una instancia nueva de la clase TraceSource usando el nombre especificado para el origen.
Método públicoTraceSource(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.
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 el recolector de basura. (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 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.
Método públicoTraceData(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.
Método públicoTraceEvent(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.
Método públicoTraceEvent(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.
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 con el tipo de evento, el identificador de evento y el formato y la matriz de argumentos especificados.
Método públicoTraceInformation(String)Escribe un mensaje informativo en los agentes de escucha de seguimiento de la colección Listeners con 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 con la matriz de objetos y la información de formato especificadas.
Método públicoTraceTransferEscribe 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.
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. 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 puede utilizarse para determinar donde se pueden enviar la información de seguimiento y ¿cuáles son los 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>

El TraceSource clase se identifica mediante el nombre de un origen, normalmente 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, permitir que todos los mensajes procedentes de ese componente identificarlos fácilmente.

TraceSource Define métodos de traza pero en realidad 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.

NotaNota

No debe llamar a los métodos de traza durante la finalización. Si lo hace puede producir un ObjectDisposedException producida.

Puede personalizar el destino de los resultados de seguimiento 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, vea Elemento <listeners> de <source> y <sharedListeners> (Elemento).

NotaNota

Agregar un agente de escucha de seguimiento para la 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.

El 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 sobre cómo utilizar el archivo de configuración para establecer un modificador, vea Switch y Cómo: Crear, inicializar y configurar modificadores de seguimiento.

NotaNota

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 del 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 a la 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 siguiente ejemplo establece el AutoFlush propiedad false y 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

Compatible con: 4.6, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

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 es compatible con todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, consulte Requisitos de sistema de .NET Framework.

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

Adiciones de comunidad

AGREGAR
Mostrar:
© 2015 Microsoft