MessageFilter Clase

Definición

Clase base abstract para distintas clases de filtros utilizadas para realizar consultas en mensajes.abstract base class for different classes of filters used to query messages.

public ref class MessageFilter abstract
[System.Runtime.Serialization.DataContract]
[System.Runtime.Serialization.KnownType(typeof(System.ServiceModel.Dispatcher.ActionMessageFilter))]
[System.Runtime.Serialization.KnownType(typeof(System.ServiceModel.Dispatcher.XPathMessageFilter))]
[System.Runtime.Serialization.KnownType(typeof(System.ServiceModel.Dispatcher.MatchAllMessageFilter))]
[System.Runtime.Serialization.KnownType(typeof(System.ServiceModel.Dispatcher.MatchNoneMessageFilter))]
public abstract class MessageFilter
[<System.Runtime.Serialization.DataContract>]
[<System.Runtime.Serialization.KnownType(typeof(System.ServiceModel.Dispatcher.ActionMessageFilter))>]
[<System.Runtime.Serialization.KnownType(typeof(System.ServiceModel.Dispatcher.XPathMessageFilter))>]
[<System.Runtime.Serialization.KnownType(typeof(System.ServiceModel.Dispatcher.MatchAllMessageFilter))>]
[<System.Runtime.Serialization.KnownType(typeof(System.ServiceModel.Dispatcher.MatchNoneMessageFilter))>]
type MessageFilter = class
Public MustInherit Class MessageFilter
Herencia
MessageFilter
Derivado
Atributos

Comentarios

MessageFilter es una clase abstract que los desarrolladores implementan para especificar los criterios que se van a usar para inspeccionar los mensajes.MessageFilter is an abstract class that developers implement in order to specify the criteria to use for inspecting messages. Normalmente, una aplicación de punto de conexión utiliza filtros para determinar qué hacer con un mensaje en función de un examen de alguna parte del mensaje.Typically, filters are used by an endpoint application to determine what to do with a message based on an examination of some part of the message. Un proceso de cola, por ejemplo, puede utilizar una consulta de XPath 1.0 para comprobar el elemento de prioridad de un encabezado conocido para determinar si poner un mensaje al principio de la cola.A queuing process, for example, can use an XPath 1.0 query to check the priority element of a known header to determine whether to move a message to the front of the queue.

Los filtros se almacenan en una tabla de filtros que implementa IMessageFilterTable<TFilterData>.Filters are stored in a filter table that implements IMessageFilterTable<TFilterData>. Cada filtro de la tabla está asociado a datos de filtro especificados que se pueden utilizar para indicar qué acciones se deben tomar si un mensaje coincide con el filtro.Each filter in the table is associated with specified filter data that can be used to indicate what actions to take if a message matches the filter. Los métodos de Match se utilizan para determinar si un mensaje satisface un filtro.The Match methods are used to determine if a message satisfies a filter.

Los criterios utilizados por un filtro no se pueden cambiar una vez que se ha construido el filtro, porque las tablas de filtros no cuentan con una forma de detectar cambios.The criteria used by a filter cannot be changed once the filter is constructed because the filter tables have no way to detect a change. La única manera de modificar los criterios de un filtro es la de construir otro y eliminar el filtro existente.The only way to modify the criteria of a filter is to construct a new one and delete the existing filter.

Las clases siguientes implementan la clase abstractMessageFilter:The following classes implement the abstractMessageFilter class:

ChannelListenerBase<TChannel> es una clase base abstract que se puede utilizar para escribir agentes de escucha que no se ponen en cola.ChannelListenerBase<TChannel> is an abstract base class that you can use for writing non-queuing listeners.

Constructores

MessageFilter()

Cuando se llama en una clase derivada, inicializa una nueva instancia de la clase MessageFilter.When called in a derived class, initializes a new instance of the MessageFilter class.

Métodos

CreateFilterTable<FilterData>()

Crea una tabla de filtros para un filtro que tiene un tipo de datos especificado asociado.Creates a filter table for a filter that has a specified type of data associated with it.

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
Match(Message)

Si se invalida en una clase derivada, prueba si un mensaje satisface los criterios del filtro.When overridden in a derived class, tests whether a message satisfies the filter criteria. No se puede examinar el cuerpo del mensaje.The body cannot be examined.

Match(MessageBuffer)

Si se invalida en una clase derivada, prueba si un mensaje almacenado en búfer satisface los criterios de un filtro.When overridden in a derived class, tests whether a buffered message satisfies the criteria of a filter.

MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)

Se aplica a