Exportar (0) Imprimir
Expandir todo
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

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
)

Parámetros

cache
Tipo: System.Diagnostics.TraceEventCache
TraceEventCache que contiene información para el evento de seguimiento.
source
Tipo: System.String
Nombre del origen.
eventType
Tipo: System.Diagnostics.TraceEventType
Uno de los valores de TraceEventType que indican el tipo de evento que provocó el seguimiento.
id
Tipo: System.Int32
Número del identificador de seguimiento.
formatOrMessage
Tipo: System.String
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
Tipo: System.Object[]
Matriz de objetos de argumento.
data1
Tipo: System.Object
Objeto de datos de seguimiento.
data
Tipo: System.Object[]
Matriz de objetos de datos de seguimiento.

Valor devuelto

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

Compatible con: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, 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 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:
© 2015 Microsoft