IMessageFilterTable<TFilterData>.GetMatchingFilter Méthode

Définition

Espace de noms:

System.ServiceModel.Dispatcher

Assembly:

System.ServiceModel.dll

Retourne un filtre issu de la table dont les critères de requête sont satisfaits par un message ou par un message mis en mémoire tampon précis.

Surcharges

GetMatchingFilter(Message, MessageFilter)	Retourne une valeur qui indique si le critère de correspondance d'un et un seul filtre dans la table est respecté par le message spécifié, et retourne ce filtre dans un paramètre out.
GetMatchingFilter(MessageBuffer, MessageFilter)	Retourne une valeur qui indique si le critère de correspondance d'un et un seul filtre dans la table est respecté par le message ou le message mis en mémoire tampon spécifié, et retourne ce filtre dans un paramètre out.

Remarques

Utilisez cette méthode lorsqu'un filtre unique est supposé correspondre au message et que le filtre correspondant est requis.

Utilisez GetMatchingFilter si le contenu du corps ne nécessite pas de vérification. Utilisez GetMatchingFilter si le contenu du corps du message peut nécessiter une vérification.

GetMatchingFilter(Message, MessageFilter)

Retourne une valeur qui indique si le critère de correspondance d'un et un seul filtre dans la table est respecté par le message spécifié, et retourne ce filtre dans un paramètre out.

public:
 bool GetMatchingFilter(System::ServiceModel::Channels::Message ^ message, [Runtime::InteropServices::Out] System::ServiceModel::Dispatcher::MessageFilter ^ % filter);

public bool GetMatchingFilter (System.ServiceModel.Channels.Message message, out System.ServiceModel.Dispatcher.MessageFilter filter);

abstract member GetMatchingFilter : System.ServiceModel.Channels.Message * MessageFilter -> bool

Public Function GetMatchingFilter (message As Message, ByRef filter As MessageFilter) As Boolean

Paramètres

message

Message

Message à tester.

filter

MessageFilter

Paramètre out qui stocke le filtre respecté par le message. Si aucun filtre n'a été trouvé, le paramètre est défini à sa valeur par défaut.

Retours

Boolean

true si le critère de correspondance d'au moins un filtre dans la table est respecté par message ; false si aucun filtre n'est respecté.

Remarques

Utilisez cette méthode lorsqu'un filtre unique est supposé correspondre au message et que le filtre correspondant est requis.

Si le corps du message doit être inspecté par un filtre dans la table de filtres, utilisez la version GetMatchingFilter de la méthode.

Notes pour les responsables de l’implémentation

Si plusieurs filtres correspondent au message, une exception MultipleFilterMatchesException doit être levée.

Cette version reçoit un Message et doit lever une exception InvalidBodyAccessException si elle tente d'analyser le corps du message.

GetMatchingFilter(MessageBuffer, MessageFilter)

Retourne une valeur qui indique si le critère de correspondance d'un et un seul filtre dans la table est respecté par le message ou le message mis en mémoire tampon spécifié, et retourne ce filtre dans un paramètre out.

public:
 bool GetMatchingFilter(System::ServiceModel::Channels::MessageBuffer ^ messageBuffer, [Runtime::InteropServices::Out] System::ServiceModel::Dispatcher::MessageFilter ^ % filter);

public bool GetMatchingFilter (System.ServiceModel.Channels.MessageBuffer messageBuffer, out System.ServiceModel.Dispatcher.MessageFilter filter);

abstract member GetMatchingFilter : System.ServiceModel.Channels.MessageBuffer * MessageFilter -> bool

Public Function GetMatchingFilter (messageBuffer As MessageBuffer, ByRef filter As MessageFilter) As Boolean

Paramètres

messageBuffer

MessageBuffer

MessageBuffer à tester.

filter

MessageFilter

Paramètre out qui stocke le filtre respecté par le message. Si aucun filtre n'a été trouvé, le paramètre est défini à sa valeur par défaut.

Retours

Boolean

true si le critère de correspondance d'au moins un filtre dans la table est respecté par messageBuffer ; false si aucun filtre n'est respecté.

Remarques

Utilisez cette méthode lorsqu'un seul filtre est supposé correspondre au message mis en mémoire tampon, que le filtre correspondant doit être retourné et que le corps du message peut faire l'objet d'un inspection.