MessageFilter Classe

Définition

Espace de noms:

System.ServiceModel.Dispatcher

Assembly:

System.ServiceModel.dll

Classe de base abstract pour les différentes classes de filtres utilisées pour interroger des 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

Héritage

Object

MessageFilter

Dérivé

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

Attributs

DataContractAttribute KnownTypeAttribute

Remarques

MessageFilter est une classe abstract que les développeurs implémentent pour spécifier les critères à utiliser pour inspecter les messages. En général, les filtres sont utilisés par une application de point de terminaison pour déterminer ce qu'il faut faire d'un message suite à un examen d'une partie du message. Par exemple, un processus de mise en file d’attente peut utiliser une requête XPath 1.0 pour vérifier l’élément prioritaire d’un en-tête connu afin de déterminer s’il faut déplacer un message au début de la file d’attente.

Les filtres sont stockés dans une table de filtres qui implémente IMessageFilterTable<TFilterData>. Chaque filtre de la table est associé aux données de filtre spécifiées qui peuvent être utilisées pour indiquer les actions à exécuter si un message correspond au filtre. Les méthodes Match sont utilisées pour déterminer si un message correspond à un filtre.

Les critères utilisés par un filtre ne peuvent pas être modifiés une fois que le filtre est construit car les tables de filtres ne dispose d'aucun moyen de détecter une modification. La seule façon de modifier les critères d'un filtre est de construire un nouveau filtre et de supprimer le filtre existant.

Les classes suivantes implémentent la abstract MessageFilter classe :

• XPathMessageFilter utilise une expression Xpath 1.0 pour spécifier les critères d'une correspondance.

• MatchAllMessageFilter correspond à tous les messages.

• MatchNoneMessageFilter ne correspond à aucun message.

• ActionMessageFilter vérifie si l'action d'un message est incluse à un ensemble d'actions spécifié.

• EndpointAddressMessageFilter vérifie si un message correspond à une adresse de point de terminaison spécifiée.

ChannelListenerBase<TChannel> est une classe de base abstract que vous pouvez utiliser pour écrire des écouteurs de non mise en file d'attente.

Constructeurs

MessageFilter()

En cas d'appel dans une classe dérivée, initialise une nouvelle instance de la classe MessageFilter.

Méthodes

CreateFilterTable<FilterData>()	Crée une table de filtres pour un filtre qui a un type de données spécifié qui lui est associé.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
Match(Message)	En cas de substitution dans une classe dérivée, vérifie si un message correspond aux critères de filtre. Le corps ne peut pas être examiné.
Match(MessageBuffer)	En cas de substitution dans une classe dérivée, vérifie si un message mis en mémoire tampon correspond aux critères d'un filtre.
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)