IMessageFilterTable<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'un filtre dans la table, et retourne les données du filtre correspondant.

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 filtre dans la table, et ajoute les données de filtre correspondantes à une collection.
GetMatchingValue(MessageBuffer, TFilterData)	Retourne une valeur qui indique si le critère de correspondance d'exactement un filtre dans la table est respecté par le message mis en mémoire tampon spécifié, et ajoute les données de filtre correspondantes à une collection.

Remarques

Utilisez l'une de ces méthodes lorsqu'un seul filtre, au plus, est censé correspondre au message et que seules les données du filtre correspondant doivent être récupérées. Ces méthodes retournent une valeur booléenne qui indique si un filtre correspondant a été trouvé, et affectent au paramètre de référence data les données de filtre correspondantes.

Utilisez GetMatchingFilter, si le corps du message n'est inspecté par aucun des filtres issus de la table de filtres.

Si le corps du message peut être inspecté par un filtre dans la table de filtres, mettez le message en mémoire tampon et transmettez-le à la version GetMatchingFilter de la méthode.

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 filtre dans la table, et ajoute les données de filtre correspondantes à une collection.

public:
 bool GetMatchingValue(System::ServiceModel::Channels::Message ^ message, [Runtime::InteropServices::Out] TFilterData % value);

public bool GetMatchingValue (System.ServiceModel.Channels.Message message, out TFilterData value);

abstract member GetMatchingValue : System.ServiceModel.Channels.Message * 'FilterData -> bool

Public Function GetMatchingValue (message As Message, ByRef value As TFilterData) As Boolean

Paramètres

message

Message

Message à tester.

value

TFilterData

outparamètre qui stocke le FilterData qui correspond à .message

Retours

Boolean

true si le message respecte le critère de correspondance d'un filtre de la table ; false dans le cas contraire.

Remarques

Utilisez cette méthode lorsqu'un seul filtre est supposé correspondre au message mis en mémoire tampon et que seul les données du filtre correspondant doivent être récupérées.

Cette méthode attend un seul filtre correspondant maximum. Si plusieurs filtres correspondants sont retrouvés, une exception MultipleFilterMatchesException doit être levée.

Si le corps du message doit être inspecté par un filtre dans la table de filtres, mettez le message en mémoire tampon à l'aide de la méthode CreateBufferedCopy puis transmettez-le à la version GetMatchingValue 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 surcharge reçoit un Message et doit lever une exception InvalidBodyAccessException si elle tente d'analyser le corps du message.

GetMatchingValue(MessageBuffer, TFilterData)

Retourne une valeur qui indique si le critère de correspondance d'exactement un filtre dans la table est respecté par le message mis en mémoire tampon spécifié, et ajoute les données de filtre correspondantes à une collection.

public:
 bool GetMatchingValue(System::ServiceModel::Channels::MessageBuffer ^ messageBuffer, [Runtime::InteropServices::Out] TFilterData % value);

public bool GetMatchingValue (System.ServiceModel.Channels.MessageBuffer messageBuffer, out TFilterData value);

abstract member GetMatchingValue : System.ServiceModel.Channels.MessageBuffer * 'FilterData -> bool

Public Function GetMatchingValue (messageBuffer As MessageBuffer, ByRef value As TFilterData) As Boolean

Paramètres

messageBuffer

MessageBuffer

MessageBuffer à tester.

value

TFilterData

outparamètre qui stocke le FilterData qui correspond à .messageBuffer

Retours

Boolean

true si le message respecte le critère de correspondance d'un filtre de la table ; false dans le cas contraire.

Remarques

Utilisez cette méthode lorsqu'un seul filtre est supposé correspondre au message mis en mémoire tampon, que les données du filtre correspondant doivent être récupérées et que le corps du message peut être amené à être inspecté.

Notes pour les responsables de l’implémentation

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