Freigeben über


XPathMessageFilter.Match Methode

Definition

Ermittelt, ob eine Nachricht bzw. ein XML-Dokument die Abfragekriterien des XPath-Filters erfüllt.

Überlädt

Match(Message)

Testet, ob eine angegebene Nachricht die Kriterien des XPath-Filters erfüllt. Für dieses Formular ist der Zugriff auf den Nachrichtentext nicht zulässig.

Match(MessageBuffer)

Ermittelt, ob eine gepufferte Nachricht die Abfragekriterien des XPath-Filters erfüllt.

Match(SeekableXPathNavigator)

Ermittelt, ob das von dem angegebenen optimierten XPath-Navigator bereitgestellte XML-Dokument die Abfragekriterien des XPath-Filters erfüllt.

Match(XPathNavigator)

Wertet den Filter anhand des angegebenen XPath-Navigators aus.

Hinweise

Diese Methoden vergleichen einen Filter mit einer Nachricht. Wenn Sie mehrere Filter mit der Nachricht vergleichen müssen, fügen Sie die Filter in eine Filtertabelle ein, und verwenden Sie dann die Vergleichsmethoden der Tabelle.

Wenn Sie nur die Nachrichtenheader und nicht den Nachrichtentext prüfen müssen, verwenden Sie die Match-Methode.

Wenn Sie Teile des Nachrichtentexts prüfen müssen, verwenden Sie die Match-Methode.

Verwenden Sie für Tests, die XPath-Abfragen einschließen, eine der verbleibenden Überladungen von Match.

Match(Message)

Testet, ob eine angegebene Nachricht die Kriterien des XPath-Filters erfüllt. Für dieses Formular ist der Zugriff auf den Nachrichtentext nicht zulässig.

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

Parameter

message
Message

Der zu überprüfende Message.

Gibt zurück

Boolean

true, wenn Message die Filterkriterien erfüllt, andernfalls false.

Ausnahmen

message ist null.

Bei der XPath-Auswertung wurde versucht, den Nachrichtentext zu überprüfen.

Ein Compilerfehler ist aufgetreten.

Hinweise

Verwenden Sie die XPathMessageFilter.Match-Methode, um Teile des Nachrichtentexts zu überprüfen. Diese Methode löst eine Ausnahme aus, wenn die Engine versucht, zur Auswertung des XPath-Ausdrucks auf den Nachrichtentext zuzugreifen. Auf diese Weise wird sichergestellt, dass die Filter-Engine nicht auf den Textstream zugreift.

Gilt für

Match(MessageBuffer)

Ermittelt, ob eine gepufferte Nachricht die Abfragekriterien des XPath-Filters erfüllt.

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

Parameter

messageBuffer
MessageBuffer

Der zu überprüfende MessageBuffer.

Gibt zurück

Boolean

true, wenn Match(MessageBuffer) die Filterkriterien erfüllt; andernfalls false.

Ausnahmen

message ist null.

Ein Compilerfehler ist aufgetreten.

Hinweise

Verwenden Sie diese Überladung der Match-Methode, wenn ein MessageBuffer verfügbar ist. Für dieses Formular ist der Zugriff auf den Nachrichtentext zulässig.

Gilt für

Match(SeekableXPathNavigator)

Ermittelt, ob das von dem angegebenen optimierten XPath-Navigator bereitgestellte XML-Dokument die Abfragekriterien des XPath-Filters erfüllt.

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

Parameter

navigator
SeekableXPathNavigator

SeekableXPathNavigator stellt die Daten für den Test bereit.

Gibt zurück

Boolean

true, wenn die Daten von SeekableXPathNavigator die Filterkriterien erfüllen, andernfalls false.

Ausnahmen

navigator ist null.

Ein Compilerfehler ist aufgetreten.

Hinweise

Die SeekableXPathNavigator-Klasse erweitert die XPathNavigator-Klasse um Methoden, mit denen Abfragen effizienter ausgeführt werden können.

Gilt für

Match(XPathNavigator)

Wertet den Filter anhand des angegebenen XPath-Navigators aus.

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

Parameter

navigator
XPathNavigator

XPathNavigator stellt die Daten für den Test bereit.

Gibt zurück

Boolean

true, wenn die Daten von XPathNavigator die Filterkriterien erfüllen, andernfalls false.

Ausnahmen

navigator ist null.

Ein Compilerfehler ist aufgetreten.

Gilt für