IMessageFilterTable<TFilterData>.GetMatchingFilter Méthode
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.
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 |
| 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 |
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)
- Source:
- IMessageFilterTable.cs
- Source:
- IMessageFilterTable.cs
- Source:
- IMessageFilterTable.cs
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 -> boolPublic Function GetMatchingFilter (message As Message, ByRef filter As MessageFilter) As BooleanParamètres
- 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
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.
S’applique à
GetMatchingFilter(MessageBuffer, MessageFilter)
- Source:
- IMessageFilterTable.cs
- Source:
- IMessageFilterTable.cs
- Source:
- IMessageFilterTable.cs
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 -> boolPublic Function GetMatchingFilter (messageBuffer As MessageBuffer, ByRef filter As MessageFilter) As BooleanParamè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
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.
