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 répond aux critères de requête du filtre XPath.

Surcharges

Nom Description
Match(Message)

Teste si un message spécifié répond 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 répond 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é répond 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 filtres dans une table de filtres, puis utilisez les méthodes de correspondance fournies par la table.

Si vous devez uniquement tester les en-têtes de message et non le corps du message, utilisez la Match méthode.

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

Pour les tests qui impliquent des requêtes XPath, utilisez l’une des surcharges restantes du Match.

Match(Message)

Teste si un message spécifié répond 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 le Message filtre répond aux critères de filtre ; sinon, false.

Exceptions

ArgumentNullException

message a la valeur null.

InvalidBodyAccessException

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

XPathException

Une erreur du compilateur s’est produite.

Remarques

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

S’applique à

Match(MessageBuffer)

Détermine si un message mis en mémoire tampon répond 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 le Match(MessageBuffer) filtre répond aux critères de filtre ; sinon false.

Exceptions

ArgumentNullException

message a la valeur null.

XPathException

Une erreur du compilateur s’est produite.

Remarques

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

S’applique à

Match(SeekableXPathNavigator)

Détermine si le document XML fourni par le navigateur XPath optimisé spécifié répond 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

Qui SeekableXPathNavigator fournit des données à tester.

Retours

Boolean

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

Exceptions

ArgumentNullException

navigator a la valeur null.

XPathException

Une erreur du compilateur s’est produite.

Remarques

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

S’applique à

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

Qui XPathNavigator fournit des données à tester.

Retours

Boolean

true si les données du XPathNavigator filtre répondent aux critères de filtre ; false sinon.

Exceptions

ArgumentNullException

navigator a la valeur null.

XPathException

Une erreur du compilateur s’est produite.

S’applique à