MessageFilter Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
-
MessageFilter
- Dérivé
- Attributs
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) |