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: noviembre 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()

Devuelve 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.

The T:System.Diagnostics.TraceSource class is used by applications to produce traces that can be associated with the application. T:System.Diagnostics.TraceSource provides tracing methods that allow you to easily trace events, trace data, and issue informational traces. Trace output from T:System.Diagnostics.TraceSource can be controlled by configuration file settings. The configuration file is located in the folder with the application executable and has the name of the application with the .config file name extension added. For example, the name of the configuration file for TraceSourceSample.exe is TraceSourceSample.exe.config. The configuration file can be used to determine where the trace information is to be sent and what levels of activity are to be traced. The following example shows the contents of a sample application configuration file.

<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>

The T:System.Diagnostics.TraceSource class is identified by the name of a source, typically the name of the application. The trace messages coming from a particular component can be initiated by a particular trace source, allowing all messages coming from that component to be easily identified.

TraceSource defines tracing methods but does not actually provide any specific mechanism for generating and storing tracing data. The tracing data is produced by trace listeners, which are plug-ins that can be loaded by trace sources.

System_CAPS_noteNota

You should not call the tracing methods during finalization. Doing so can result in an T:System.ObjectDisposedException being thrown.

You can customize the tracing output's target by adding or removing T:System.Diagnostics.TraceListener instances to or from the collection stored in the P:System.Diagnostics.TraceSource.Listeners property. By default, trace output is produced using an instance of the T:System.Diagnostics.DefaultTraceListener class. The preceding configuration file example demonstrates removing the T:System.Diagnostics.DefaultTraceListener and adding a T:System.Diagnostics.ConsoleTraceListener to produce the trace output for the trace source. For more information, see <listeners> Element for <source> and <sharedListeners> Element.

System_CAPS_noteNota

Adding a trace listener to the P:System.Diagnostics.TraceSource.Listeners collection can cause an exception to be thrown while tracing, if a resource used by the trace listener is not available. The conditions and the exception thrown depend on the trace listener and cannot be enumerated in this topic. It may be useful to place calls to the T:System.Diagnostics.TraceSource methods in try/catch blocks to detect and handle any exceptions from trace listeners.

The T:System.Diagnostics.SourceSwitch class provides the means to dynamically control the tracing output. The preceding configuration file example shows how you can turn off tracing from a trace source and control the level at which tracing occurs. You can modify the value of the source switch without recompiling your application. For information on using the configuration file to set a switch, see T:System.Diagnostics.Switch and How to: Configure Trace Switches.

System_CAPS_noteNota

If you modify a configuration file while an application is executing, the application must be stopped and restarted or the M:System.Diagnostics.Trace.Refresh method must be called before the new settings take effect.

The T:System.Diagnostics.TraceEventType enumeration is used to define the event type of the trace message. Trace filters use the T:System.Diagnostics.TraceEventType to determine if a trace listener should produce the trace message.

The trace listeners can optionally have an additional layer of filtering through a trace filter. If a trace listener has an associated filter, the listener calls the M:System.Diagnostics.TraceFilter.ShouldTrace(System.Diagnostics.TraceEventCache,System.String,System.Diagnostics.TraceEventType,System.Int32,System.String,System.Object[],System.Object,System.Object[]) method on that filter to determine whether or not to produce the trace information.

The trace listeners use the values of the T:System.Diagnostics.Trace class properties M:System.Diagnostics.Trace.Indent, P:System.Diagnostics.Trace.IndentSize, and P:System.Diagnostics.Trace.AutoFlush to format trace output. You can use configuration file attributes to set the M:System.Diagnostics.Trace.Indent, P:System.Diagnostics.Trace.IndentSize, and P:System.Diagnostics.Trace.AutoFlush properties. The following example sets the P:System.Diagnostics.Trace.AutoFlush property to false and the P:System.Diagnostics.Trace.IndentSize property to 3.

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

The following code example shows the use of the T:System.Diagnostics.TraceSource class to forward traces to listeners. The example also demonstrates switch and filter usage.

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

.NET Framework
Disponible desde 2.0

This type is thread safe.

Volver al principio
Mostrar: