Exportar (0) Imprimir
Expandir todo
Este artículo se tradujo de forma manual. Mueva el puntero sobre las frases del artículo para ver el texto original.
Traducción
Original

TraceSource.TraceEvent (Método) (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.

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

[ConditionalAttribute("TRACE")]
public void TraceEvent(
	TraceEventType eventType,
	int id,
	string message
)

Parámetros

eventType
Tipo: System.Diagnostics.TraceEventType
Uno de los valores de enumeración que especifica el tipo de evento de los datos de seguimiento.
id
Tipo: System.Int32
Identificador numérico para el evento.
message
Tipo: System.String
Mensaje de seguimiento que se va a escribir.

ExcepciónCondición
ObjectDisposedException

Se ha intentado realizar la traza de un evento durante la finalización.

El método TraceEvent sirve para realizar un seguimiento de los eventos que se pueden procesar automáticamente mediante herramientas. Por ejemplo, una herramienta de supervisión puede notificar a un administrador si un origen concreto realiza el seguimiento de un evento específico.

El método TraceEvent llama al método ShouldTrace del objeto SourceSwitch devuelto por la propiedad Switch. Si ShouldTrace devuelve true, TraceEvent llama al método TraceEvent correspondiente de cada agente de escucha. En caso contrario, TraceEvent devuelve un valor sin llamar a los métodos de los agentes de escucha.

El contenido de seguimiento es específico de cada agente de escucha. Si la implementación del agente de escucha no reemplaza el método, el resultado predeterminado es el nombre del origen de seguimiento, su identidad numérica, el tipo de evento y el mensaje. Cualquier contenido de seguimiento adicional depende del valor de la propiedad TraceOutputOptions del agente de escucha.

NotaNota

El objeto EventLogTraceListener se limita a un valor máximo id de 65.535. Si el valor especificado en id es mayor de 65.535, el objeto EventLogTraceListener usa 65.535.

En el ejemplo de código siguiente se muestra el uso del método TraceEvent(TraceEventType, Int32) para pasar un evento de seguimiento a los agentes de escucha. Este ejemplo de código forma parte de un ejemplo más extenso referente a la clase TraceSource.


// Issue file not found message as a warning.
ts.TraceEvent(TraceEventType.Warning, 2, "File Test not found");


.NET Framework

Compatible con: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

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

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft