XPathMessageFilter.Match Methode

Definition

Namespace:

System.ServiceModel.Dispatcher

Assembly:

System.ServiceModel.dll

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

ArgumentNullException

message ist null.

InvalidBodyAccessException

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

XPathException

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.

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

ArgumentNullException

message ist null.

XPathException

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.

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

ArgumentNullException

navigator ist null.

XPathException

Ein Compilerfehler ist aufgetreten.

Hinweise

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

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

ArgumentNullException

navigator ist null.

XPathException

Ein Compilerfehler ist aufgetreten.