MessageFilterTable<TFilterData>.GetMatchingValue Méthode

Définition

Espace de noms:

System.ServiceModel.Dispatcher

Assembly:

System.ServiceModel.dll

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

message

Message

Message à tester.

data

TFilterData

Paramètre out qui stocke les FilterData correspondant à message.

Retours

Boolean

true si le critère de correspondance d'un filtre de la table est respecté par le message ; sinon, false.

Implémente

GetMatchingValue(Message, TFilterData)

Exceptions

MultipleFilterMatchesException

Plusieurs filtres correspondent à message.

InvalidBodyAccessException

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.

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

Boolean

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

GetMatchingValue(MessageBuffer, TFilterData)

Exceptions

MultipleFilterMatchesException

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.