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 de la table dont les critères de requête sont satisfaits par un message ou un message mis en mémoire tampon spécifié.
Surcharges
| Nom | Description |
|---|---|
| GetMatchingFilter(Message, MessageFilter) |
Retourne une valeur qui indique si le critère de correspondance d’un filtre exactement dans la table est satisfait par le message spécifié et retourne ce filtre dans un |
| GetMatchingFilter(MessageBuffer, MessageFilter) |
Retourne une valeur qui indique si le critère de correspondance d’un filtre exactement dans la table est satisfait par le message spécifié ou le message mis en mémoire tampon et retourne ce filtre dans un |
Remarques
Utilisez cette méthode lorsqu’un seul filtre est censé correspondre au message et que le filtre correspondant est requis.
Utilisez GetMatchingFilter si le contenu du corps ne nécessite pas d’examen. Utilisez cette option GetMatchingFilter si le contenu du corps du message peut nécessiter un examen.
GetMatchingFilter(Message, MessageFilter)
Retourne une valeur qui indique si le critère de correspondance d’un filtre exactement dans la table est satisfait par le message spécifié et retourne ce filtre dans un out paramètre.
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
out paramètre qui stocke le filtre satisfait par le message. Si aucun filtre n’a été trouvé, le paramètre est défini sur sa valeur par défaut.
Retours
true si le critère de correspondance d’au moins un filtre dans la table est satisfait par message; false si aucun filtre n’est satisfait.
Remarques
Utilisez cette méthode lorsqu’un seul filtre est censé 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 GetMatchingFilter version de la méthode.
Notes pour les responsables de l’implémentation
Si plusieurs filtres correspondent au message, un MultipleFilterMatchesException doit être levée.
Cette version prend une Message version et doit lever une InvalidBodyAccessException valeur si elle tente d’examiner le corps du message.
S’applique à
GetMatchingFilter(MessageBuffer, MessageFilter)
Retourne une valeur qui indique si le critère de correspondance d’un filtre exactement dans la table est satisfait par le message spécifié ou le message mis en mémoire tampon et retourne ce filtre dans un out paramètre.
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
out paramètre qui stocke le filtre satisfait par le message. Si aucun filtre n’a été trouvé, le paramètre est défini sur sa valeur par défaut.
Retours
true si le critère de correspondance d’au moins un filtre dans la table est satisfait par messageBuffer; false si aucun filtre n’est satisfait.
Remarques
Utilisez cette méthode lorsqu’un seul filtre est censé correspondre au message mis en mémoire tampon, le filtre correspondant doit être retourné et le corps du message peut être inspecté.