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

TraceFilter.ShouldTrace (Método) (TraceEventCache, String, TraceEventType, Int32, String, Object[], Object, Object[])

 

Cuando se reemplaza en una clase derivada, determina si el agente de escucha de seguimiento debe realizar un seguimiento del evento.

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

public abstract bool ShouldTrace(
	TraceEventCache cache,
	string source,
	TraceEventType eventType,
	int id,
	string formatOrMessage,
	object[] args,
	object data1,
	object[] data
)

Parámetros

cache

TraceEventCache que contiene información para el evento de seguimiento.

source

Nombre del origen.

eventType

Uno de los valores de TraceEventType que indican el tipo de evento que provocó el seguimiento.

id

Número del identificador de seguimiento.

formatOrMessage

Formato que se va a utilizar para escribir una matriz de argumentos especificada por el parámetro args o un mensaje que se va a escribir.

args

Matriz de objetos de argumento.

data1

Objeto de datos de seguimiento.

data

Matriz de objetos de datos de seguimiento.

Valor devuelto

Type: System.Boolean

Es true para realizar un seguimiento del evento especificado; en caso contrario, es false.

Notas para los herederos:

Las implementaciones de este método deben devolver true si debe realizarse un seguimiento del evento especificado por los parámetros que se han pasado.De lo contrario, el método debe devolver false.Por ejemplo, un filtro que sólo permite que pasen eventos de error al agente de escucha deber examinar el parámetro eventType y devolver true si el nivel del tipo de evento de seguimiento está establecido en TraceEventType.Error o un nivel mayor; de lo contrario, debe devolver false.

Las implementaciones del método deben poder controlar null en los parámetros siguientes: args, data1, data, formatOrMessage y cache.Si el valor de parámetro es null, el parámetro no forma parte del evento.Por ejemplo, si el valor del parámetro args es null, esto significa que el evento no tiene ningún argumento.Si el valor del parámetro data es null, esto significa que hay un objeto de datos o no hay ninguno.Si hay un objeto de datos, se encontrará en el parámetro data1.La distinción entre un objeto de datos único y una matriz de objetos de datos se hace por motivos de rendimiento.No hay ninguna razón para crear una matriz de objetos si sólo se realiza el seguimiento de un objeto, lo cual suele ser el caso.Si el valor del parámetro data no es null, el valor del parámetro data1 tampoco debe ser null.

Se garantiza que el valor del parámetro source no es null ni una cadena vacía ("").

Las implementaciones del método pueden producir opcionalmente las excepciones siguientes:

En el ejemplo de código siguiente se muestra cómo reemplazar el método ShouldTrace para indicar que la traza debe realizarse cuando el tipo del evento de seguimiento es igual a TraceEventType.Error.

public class ErrorFilter : TraceFilter
{
    override public bool ShouldTrace(TraceEventCache cache, string source,
        TraceEventType eventType, int id, string formatOrMessage,
        object[] args, object data, object[] dataArray)
    {
        return eventType == TraceEventType.Error;
    }
}

.NET Framework
Disponible desde 2.0
Volver al principio
Mostrar: