MessageFilter Classe

Définition

Classe de base abstract pour les différentes classes de filtres utilisées pour interroger des messages.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.MatchNoneMessageFilter))]
[System.Runtime.Serialization.KnownType(typeof(System.ServiceModel.Dispatcher.ActionMessageFilter))]
[System.Runtime.Serialization.KnownType(typeof(System.ServiceModel.Dispatcher.MatchAllMessageFilter))]
[System.Runtime.Serialization.KnownType(typeof(System.ServiceModel.Dispatcher.XPathMessageFilter))]
public abstract class MessageFilter
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.MessageFilter is an abstract class that developers implement in order to specify the criteria to use for inspecting 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.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. 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.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.

Les filtres sont stockés dans une table de filtres qui implémente IMessageFilterTable<TFilterData>.Filters are stored in a filter table that implements 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.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. Les méthodes Match sont utilisées pour déterminer si un message correspond à un filtre.The Match methods are used to determine if a message satisfies a filter.

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.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 seule façon de modifier les critères d'un filtre est de construire un nouveau filtre et de supprimer le filtre existant.The only way to modify the criteria of a filter is to construct a new one and delete the existing filter.

Les classes suivantes implémentent la classe abstractMessageFilter :The following classes implement the abstractMessageFilter class:

ChannelListenerBase<TChannel> est une classe de base abstract que vous pouvez utiliser pour écrire des écouteurs de non mise en file d'attente.ChannelListenerBase<TChannel> is an abstract base class that you can use for writing non-queuing listeners.

Constructeurs

MessageFilter()

En cas d'appel dans une classe dérivée, initialise une nouvelle instance de la classe MessageFilter.When called in a derived class, initializes a new instance of the MessageFilter class.

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é.Creates a filter table for a filter that has a specified type of data associated with it.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetHashCode()

Sert de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(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.When overridden in a derived class, tests whether a message satisfies the filter criteria. Le corps ne peut pas être examiné.The body cannot be examined.

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.When overridden in a derived class, tests whether a buffered message satisfies the criteria of a filter.

MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l'objet en cours.Returns a string that represents the current object.

(Hérité de Object)

S’applique à