ShouldTrace (Método)
Collapse the table of content
Expand the table of content

TraceFilter.ShouldTrace (Método)

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
)
public abstract boolean ShouldTrace (
	TraceEventCache cache, 
	String source, 
	TraceEventType eventType, 
	int id, 
	String formatOrMessage, 
	Object[] args, 
	Object data1, 
	Object[] data
)
public abstract function ShouldTrace (
	cache : TraceEventCache, 
	source : String, 
	eventType : TraceEventType, 
	id : int, 
	formatOrMessage : String, 
	args : Object[], 
	data1 : Object, 
	data : Object[]
) : boolean
No aplicable.

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

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 referencia null (Nothing en Visual Basic) en los parámetros siguientes: args, data1, data, formatOrMessage y cache. Si el valor de parámetro es referencia null (Nothing en Visual Basic), el parámetro no forma parte del evento. Por ejemplo, si el valor del parámetro args es referencia null (Nothing en Visual Basic), esto significa que el evento no tiene ningún argumento. Si el valor del parámetro data es referencia null (Nothing en Visual Basic), 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 referencia null (Nothing en Visual Basic), el valor del parámetro data1 tampoco debe ser referencia null (Nothing en Visual Basic). Se garantiza que el valor del parámetro source no es referencia null (Nothing en Visual Basic) 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 el seguimiento debe realizarse cuando el tipo del evento de seguimiento es igual a TraceEventType.Error.

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

Windows 98, Windows 2000 Service Pack 4, Windows Millennium, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0

Adiciones de comunidad

AGREGAR
Mostrar:
© 2016 Microsoft