MessageFilter Clase

Definición

Espacio de nombres:

System.ServiceModel.Dispatcher

Ensamblado:

System.ServiceModel.Primitives.dll

Paquete:

System.ServiceModel.Primitives v6.2.0

Source:

MessageFilter.cs

Clase base abstract para distintas clases de filtros utilizadas para realizar consultas en mensajes.

public ref class MessageFilter abstract

[System.Runtime.Serialization.DataContract]
public abstract class MessageFilter

[<System.Runtime.Serialization.DataContract>]
type MessageFilter = class

Public MustInherit Class MessageFilter

Herencia

Object

MessageFilter

Derivado

System.ServiceModel.CorrelationActionMessageFilter

System.ServiceModel.Dispatcher.ActionMessageFilter

System.ServiceModel.Dispatcher.EndpointAddressMessageFilter

System.ServiceModel.Dispatcher.EndpointNameMessageFilter

System.ServiceModel.Dispatcher.MatchAllMessageFilter

System.ServiceModel.Dispatcher.MatchNoneMessageFilter

System.ServiceModel.Dispatcher.PrefixEndpointAddressMessageFilter

System.ServiceModel.Dispatcher.StrictAndMessageFilter

System.ServiceModel.Dispatcher.XPathMessageFilter

Atributos

DataContractAttribute

Comentarios

MessageFilter es una clase abstract que los desarrolladores implementan para especificar los criterios que se van a usar para inspeccionar los mensajes. 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. 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.

Los filtros se almacenan en una tabla de filtros que implementa 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. Los métodos de Match se utilizan para determinar si un mensaje satisface un filtro.

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. La única manera de modificar los criterios de un filtro es la de construir otro y eliminar el filtro existente.

Las clases siguientes implementan la clase abstractMessageFilter:

• XPathMessageFilter utiliza una expresión XPath 1.0 para especificar los criterios de una coincidencia.

• MatchAllMessageFilter hace que coincidan todos los mensajes.

• MatchNoneMessageFilter hace que no coincida ninguno de los mensajes.

• ActionMessageFilter prueba si la acción de un mensaje forma parte de un conjunto especificado de acciones.

• EndpointAddressMessageFilter prueba si un mensaje satisface una dirección de extremo especificada.

ChannelListenerBase<TChannel> es una clase base abstract que se puede utilizar para escribir agentes de escucha que no se ponen en cola.

Constructores

MessageFilter()

Cuando se llama en una clase derivada, inicializa una nueva instancia de la clase MessageFilter.

Métodos

CreateFilterTable<FilterData>()	Crea una tabla de filtros para un filtro que tiene un tipo de datos especificado asociado.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
Match(Message)	Si se invalida en una clase derivada, prueba si un mensaje satisface los criterios del filtro. No se puede examinar el cuerpo del mensaje.
Match(MessageBuffer)	Si se invalida en una clase derivada, prueba si un mensaje almacenado en búfer satisface los criterios de un filtro.
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)