XPathMessageFilterTable<TFilterData>.GetMatchingValue Méthode

Définition

Espace de noms:

System.ServiceModel.Dispatcher

Assembly:

System.ServiceModel.dll

Retourne une valeur qui indique si l’objet de document spécifié respecte le critère de correspondance d’une occurrence de XPathMessageFilter 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 indiqué respecte le critère de correspondance d'une occurrence de XPathMessageFilter dans la table, et retourne les données de filtre correspondantes.
GetMatchingValue(MessageBuffer, TFilterData)	Retourne une valeur qui indique si le message mis en mémoire tampon indiqué respecte le critère de correspondance d'une occurrence de XPathMessageFilter dans la table, et retourne les données de filtre correspondantes.
GetMatchingValue(SeekableXPathNavigator, TFilterData)	Retourne une valeur qui indique si le critère de correspondance d'une occurrence de SeekableXPathNavigator dans la table est respecté par navigator, et retourne les données de filtre correspondant dans un paramètre out.
GetMatchingValue(XPathNavigator, TFilterData)	Retourne une valeur qui indique si le critère de correspondance d'une occurrence de XPathNavigator dans la table est respecté par navigator, et retourne les données de filtre correspondant dans un paramètre out.

Remarques

Utilisez l'une de ces quatre méthodes si un seul filtre est supposé correspondre à l'objet de document et que seul le FilterData du filtre correspondant doit être récupéré.

Les deux premières méthodes sont des implémentations de GetMatchingValue.

Utilisez GetMatchingValue si le contenu du corps ne nécessite pas de vérification. Utilisez GetMatchingValue si le contenu du corps du message peut nécessiter une vérification.

Les deux autres méthodes sont des surcharges spécifiques de XPathMessageFilterTable<TFilterData>. Pour filtrer en fonction d'un document fourni via un navigateur, utilisez GetMatchingValue ou GetMatchingValue.

GetMatchingValue(Message, TFilterData)

Retourne une valeur qui indique si le message indiqué respecte le critère de correspondance d'une occurrence de XPathMessageFilter dans la table, et retourne 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 pour le filtre 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

ArgumentNullException

message a la valeur null.

MultipleFilterMatchesException

Plusieurs filtres correspondent à 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 GetMatchingValue.

GetMatchingValue(MessageBuffer, TFilterData)

Retourne une valeur qui indique si le message mis en mémoire tampon indiqué respecte le critère de correspondance d'une occurrence de XPathMessageFilter dans la table, et retourne les données de filtre correspondantes.

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

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

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

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

Paramètres

messageBuffer

MessageBuffer

MessageBuffer à tester.

data

TFilterData

Paramètre out qui stocke les FilterData pour le filtre correspondant à messageBuffer.

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

ArgumentNullException

message a la valeur null.

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é.

Cette méthode implémente GetMatchingFilter.

GetMatchingValue(SeekableXPathNavigator, TFilterData)

Retourne une valeur qui indique si le critère de correspondance d'une occurrence de SeekableXPathNavigator dans la table est respecté par navigator, et retourne les données de filtre correspondant dans un paramètre out.

public:
 bool GetMatchingValue(System::ServiceModel::Dispatcher::SeekableXPathNavigator ^ navigator, [Runtime::InteropServices::Out] TFilterData % data);

public bool GetMatchingValue (System.ServiceModel.Dispatcher.SeekableXPathNavigator navigator, out TFilterData data);

member this.GetMatchingValue : System.ServiceModel.Dispatcher.SeekableXPathNavigator * 'FilterData -> bool

Public Function GetMatchingValue (navigator As SeekableXPathNavigator, ByRef data As TFilterData) As Boolean

Paramètres

navigator

SeekableXPathNavigator

SeekableXPathNavigator à tester.

data

TFilterData

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

Retours

Boolean

true si le critère de correspondance d'un et un seul filtre de la table est respecté par navigator ; false si aucun filtre n'est respecté.

Exceptions

ArgumentNullException

navigator a la valeur null.

MultipleFilterMatchesException

Plusieurs filtres correspondent à navigator.

Remarques

Utilisez cette méthode pour spécifier une condition XPath que le message doit respecter.

Cette méthode est similaire à GetMatchingValue, mais elle utilise SeekableXPathNavigator, qui étend les fonctionnalités de XPathNavigator afin d'inclure des méthodes autorisant des optimisations différentes.

GetMatchingValue(XPathNavigator, TFilterData)

Retourne une valeur qui indique si le critère de correspondance d'une occurrence de XPathNavigator dans la table est respecté par navigator, et retourne les données de filtre correspondant dans un paramètre out.

public:
 bool GetMatchingValue(System::Xml::XPath::XPathNavigator ^ navigator, [Runtime::InteropServices::Out] TFilterData % data);

public bool GetMatchingValue (System.Xml.XPath.XPathNavigator navigator, out TFilterData data);

member this.GetMatchingValue : System.Xml.XPath.XPathNavigator * 'FilterData -> bool

Public Function GetMatchingValue (navigator As XPathNavigator, ByRef data As TFilterData) As Boolean

Paramètres

navigator

XPathNavigator

XPathNavigator à tester.

data

TFilterData

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

Retours

Boolean

true si le critère de correspondance d'un et un seul filtre de la table est respecté par navigator ; false si aucun filtre n'est respecté.

Exceptions

ArgumentNullException

navigator a la valeur null.

MultipleFilterMatchesException

Plusieurs filtres correspondent à navigator.

Remarques

Utilisez cette méthode pour spécifier une condition XPath que le message doit respecter.