XPathMessageFilter.Match Méthode

Définition

Espace de noms:

System.ServiceModel.Dispatcher

Assembly:

System.ServiceModel.dll

Détermine si un message ou un document XML satisfait aux critères de requête du filtre XPath.

Surcharges

Match(Message)	Teste si un message spécifié satisfait aux critères du filtre XPath. Ce formulaire n'est pas autorisé à accéder au corps du message.
Match(MessageBuffer)	Détermine si un message mis en mémoire tampon satisfait aux critères de requête du filtre XPath.
Match(SeekableXPathNavigator)	Détermine si le document XML fourni par le navigateur XPath optimisé spécifié satisfait aux critères de requête du filtre XPath.
Match(XPathNavigator)	Évalue le filtre sur le navigateur XPath spécifié.

Remarques

Ces méthodes vérifient un filtre par rapport à un message. Si vous devez vérifier le message par rapport à plusieurs filtres, placez-les dans une table de filtres, puis utilisez les méthodes de correspondance fournies par la table.

Si vous devez seulement tester les en-têtes de message plutôt que le corps des messages, utilisez la méthode Match.

Si vous devez tester des parties du corps des messages, utilisez la méthode Match.

Pour les tests impliquant des requêtes XPath, utilisez l’une des surcharges restantes de Match.

Match(Message)

Teste si un message spécifié satisfait aux critères du filtre XPath. Ce formulaire n'est pas autorisé à accéder au corps du message.

public:
 override bool Match(System::ServiceModel::Channels::Message ^ message);

public override bool Match (System.ServiceModel.Channels.Message message);

override this.Match : System.ServiceModel.Channels.Message -> bool

Public Overrides Function Match (message As Message) As Boolean

Paramètres

message

Message

Message à tester.

Retours

Boolean

true si l'objet Message satisfait aux critères de filtre ; sinon, false.

Exceptions

ArgumentNullException

message a la valeur null.

InvalidBodyAccessException

L’évaluation XPath a essayé d’examiner le corps du message.

XPathException

Une erreur de compilateur s'est produite.

Remarques

Utilisez la méthode XPathMessageFilter.Match pour faire correspondre des éléments du corps. Une exception est levée par cette méthode si le moteur essaie d'accéder au corps du message pour évaluer l'expression XPath. Cela permet de s'assurer que le moteur de filtre n'accède pas au flux de données du corps.

Match(MessageBuffer)

Détermine si un message mis en mémoire tampon satisfait aux critères de requête du filtre XPath.

public:
 override bool Match(System::ServiceModel::Channels::MessageBuffer ^ messageBuffer);

public override bool Match (System.ServiceModel.Channels.MessageBuffer messageBuffer);

override this.Match : System.ServiceModel.Channels.MessageBuffer -> bool

Public Overrides Function Match (messageBuffer As MessageBuffer) As Boolean

Paramètres

messageBuffer

MessageBuffer

MessageBuffer à tester.

Retours

Boolean

true si Match(MessageBuffer) satisfait aux critères de filtre ; sinon, false.

Exceptions

ArgumentNullException

message a la valeur null.

XPathException

Une erreur de compilateur s'est produite.

Remarques

Utilisez cette surcharge de la méthode Match lorsqu'un MessageBuffer est disponible. Ce formulaire est autorisé à examiner le corps du message.

Match(SeekableXPathNavigator)

Détermine si le document XML fourni par le navigateur XPath optimisé spécifié satisfait aux critères de requête du filtre XPath.

public:
 bool Match(System::ServiceModel::Dispatcher::SeekableXPathNavigator ^ navigator);

public bool Match (System.ServiceModel.Dispatcher.SeekableXPathNavigator navigator);

override this.Match : System.ServiceModel.Dispatcher.SeekableXPathNavigator -> bool

Public Function Match (navigator As SeekableXPathNavigator) As Boolean

Paramètres

navigator

SeekableXPathNavigator

SeekableXPathNavigator qui fournit des données à tester.

Retours

Boolean

true si les données de SeekableXPathNavigator satisfont aux critères de filtre ; sinon, false.

Exceptions

ArgumentNullException

navigator a la valeur null.

XPathException

Une erreur de compilateur s'est produite.

Remarques

La classe SeekableXPathNavigator étend la classe XPathNavigator avec des méthodes qui exécutent des requêtes plus efficacement.

Match(XPathNavigator)

Évalue le filtre sur le navigateur XPath spécifié.

public:
 bool Match(System::Xml::XPath::XPathNavigator ^ navigator);

public bool Match (System.Xml.XPath.XPathNavigator navigator);

override this.Match : System.Xml.XPath.XPathNavigator -> bool

Public Function Match (navigator As XPathNavigator) As Boolean

Paramètres

navigator

XPathNavigator

XPathNavigator qui fournit des données à tester.

Retours

Boolean

true si les données de XPathNavigator satisfont aux critères de filtre ; sinon, false.

Exceptions

ArgumentNullException

navigator a la valeur null.

XPathException

Une erreur de compilateur s'est produite.