MessageFilterTable<TFilterData>.GetMatchingValue 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 une valeur qui indique si le message ou le message mis en mémoire tampon indiqué respecte le critère de correspondance d’une occurrence de MessageFilter dans la table, et ajoute à une collection les données de filtre correspondantes.
Surcharges
GetMatchingValue(Message, TFilterData) |
Retourne une valeur qui indique si le message mis en mémoire tampon indiqué respecte le critère de correspondance d'un objet MessageFilter dans la table, et ajoute à une collection les données de filtre correspondantes. |
GetMatchingValue(MessageBuffer, TFilterData) |
Retourne une valeur qui indique si le message indiqué respecte le critère de correspondance d'un filtre dans la table, et ajoute les données de filtre correspondantes à une collection. |
Remarques
Utilisez l'une de ces méthodes lorsqu'un filtre unique est censé correspondre au message et que seul le FilterData
du filtre correspondant doit être récupéré.
Utilisez GetMatchingValue pour inspecter les en-têtes de message et GetMatchingValue pour inspecter un message mis en mémoire tampon, qui peut impliquer la consultation du corps du message.
GetMatchingValue(Message, TFilterData)
Retourne une valeur qui indique si le message mis en mémoire tampon indiqué respecte le critère de correspondance d'un objet MessageFilter dans la table, et ajoute à une collection les données de filtre correspondantes.
public:
virtual bool GetMatchingValue(System::ServiceModel::Channels::Message ^ message, [Runtime::InteropServices::Out] TFilterData % data);
public bool GetMatchingValue (System.ServiceModel.Channels.Message message, out TFilterData data);
abstract member GetMatchingValue : System.ServiceModel.Channels.Message * 'FilterData -> bool
override this.GetMatchingValue : System.ServiceModel.Channels.Message * 'FilterData -> bool
Public Function GetMatchingValue (message As Message, ByRef data As TFilterData) As Boolean
Paramètres
- data
- TFilterData
Paramètre out
qui stocke les FilterData
correspondant à message
.
Retours
true
si le critère de correspondance d'un filtre de la table est respecté par le message ; sinon, false
.
Implémente
Exceptions
Plusieurs filtres correspondent à message
.
Un filtre a essayé d'examiner le contenu du corps du message.
Remarques
Utilisez cette méthode lorsqu'un filtre unique est supposé correspondre au message et que seul le FilterData
du filtre correspondant doit être récupéré.
Cette méthode implémente GetMatchingFilter.
S’applique à
GetMatchingValue(MessageBuffer, TFilterData)
Retourne une valeur qui indique si le message indiqué respecte le critère de correspondance d'un filtre dans la table, et ajoute les données de filtre correspondantes à une collection.
public:
virtual bool GetMatchingValue(System::ServiceModel::Channels::MessageBuffer ^ buffer, [Runtime::InteropServices::Out] TFilterData % data);
public bool GetMatchingValue (System.ServiceModel.Channels.MessageBuffer buffer, out TFilterData data);
abstract member GetMatchingValue : System.ServiceModel.Channels.MessageBuffer * 'FilterData -> bool
override this.GetMatchingValue : System.ServiceModel.Channels.MessageBuffer * 'FilterData -> bool
Public Function GetMatchingValue (buffer As MessageBuffer, ByRef data As TFilterData) As Boolean
Paramètres
- buffer
- MessageBuffer
MessageBuffer à tester.
- data
- TFilterData
Paramètre out
qui stocke les FilterData
correspondant à buffer
.
Retours
true
si le critère de correspondance d'un filtre de la table est respecté par le message mis en mémoire tampon ; sinon, false
.
Implémente
Exceptions
Plusieurs filtres correspondent à messageBuffer
.
Remarques
Utilisez cette méthode lorsqu'un filtre unique est supposé correspondre au message mis en mémoire tampon et que seul le FilterData
du filtre correspondant doit être récupéré. Étant donné que le filtre est mis en correspondance avec un message mis en mémoire tampon, il peut spécifier des conditions dans le corps du message.
Cette méthode implémente GetMatchingFilter.