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

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

 

Publicado: octubre de 2016

Cuando se invalida 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 MustOverride Function ShouldTrace (
	cache As TraceEventCache,
	source As String,
	eventType As TraceEventType,
	id As Integer,
	formatOrMessage As String,
	args As Object(),
	data1 As Object,
	data As Object()
) As Boolean

Parámetros

cache
Type: System.Diagnostics.TraceEventCache

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

source
Type: System.String

El nombre del origen.

eventType
Type: System.Diagnostics.TraceEventType

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

id
Type: System.Int32

Un número de identificador de seguimiento.

formatOrMessage
Type: System.String

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

args
Type: System.Object()

Una matriz de objetos de argumento.

data1
Type: System.Object

Un objeto de datos de seguimiento.

data
Type: System.Object()

Una matriz de objetos de datos de seguimiento.

Valor devuelto

Type: System.Boolean

true para realizar un seguimiento del evento especificado; de lo contrario, false.

Notas para desarrolladores de herederos:

Las implementaciones de este método deben devolver true si debe realizarse un seguimiento del evento especificado por los parámetros pasados. De lo contrario, el método debe devolver false. Por ejemplo, debe inspeccionar un filtro que permite pasar a través del agente de escucha sólo eventos de error del eventType parámetro y valor devuelto true Si el nivel de tipo de evento de seguimiento está establecido en TraceEventType.Error o superior; en caso contrario, debe devolver false.

Las implementaciones del método deben estar preparadas para controlar null en los parámetros siguientes: args, data1, data, formatOrMessage, y cache. Si el valor del parámetro es null, el parámetro no es parte del evento. Por ejemplo, si la args parámetro es null, significa que el evento no tiene ningún argumento. Si el data parámetro es null, entonces hay objetos de datos de una o ninguna. Si hay un objeto de datos, se encuentra en la data1 parámetro. Es el motivo de la distinción entre un objeto de datos único y una matriz de objetos de datos de rendimiento. No hay ninguna razón para crear una matriz de objetos si sólo se realiza un seguimiento de un objeto, lo cual suele ser el caso. Si el data parámetro no es null, el data1 parámetro no debe ser también null.

Se garantiza que el source parámetro no es null y no es 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 invalidar el ShouldTrace método para indicar la traza debe aparecer cuando el tipo de evento del evento es igual a TraceEventType.Error.

Public Class ErrorFilter
    Inherits TraceFilter

    Public Overrides Function ShouldTrace ( cache As TraceEventCache, _
                source As String, eventType As TraceEventType, _
                id As Integer, formatOrMessage As String, _
                args As Object(), data As Object, _
                dataArray As Object() ) As Boolean
        If eventType = TraceEventType.Error Then
            Return True
        Else
            Return False
        End If
    End Function
End Class

.NET Framework
Disponible desde 2.0
Volver al principio
Mostrar: