Sprache

XPathMessageFilter.Match Methode

Definition

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

Überlädt

Name Beschreibung
Match(Message)

Überprüft, ob eine angegebene Nachricht die Kriterien des XPath-Filters erfüllt. Dieses Formular darf nicht auf den Textkörper der Nachricht zugreifen.

Match(MessageBuffer)

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

Match(SeekableXPathNavigator)

Bestimmt, ob das vom angegebenen optimierten XPath-Navigator bereitgestellte XML-Dokument die Abfragekriterien des XPath-Filters erfüllt.

Match(XPathNavigator)

Wertet den Filter über den angegebenen XPath-Navigator aus.

Hinweise

Diese Methoden überprüfen einen Filter für eine Nachricht. Wenn Sie die Nachricht anhand mehrerer Filter überprüfen müssen, fügen Sie die Filter in eine Filtertabelle ein, und verwenden Sie dann die von der Tabelle bereitgestellten Übereinstimmungsmethoden.

Wenn Sie nur die Nachrichtenkopfzeilen und nicht den Nachrichtentext testen müssen, verwenden Sie die Match Methode.

Wenn Sie Teile des Nachrichtentexts testen müssen, verwenden Sie die Match Methode.

Verwenden Sie für Tests, die XPath-Abfragen umfassen, eine der verbleibenden Überladungen der Match.

Match(Message)

Überprüft, ob eine angegebene Nachricht die Kriterien des XPath-Filters erfüllt. Dieses Formular darf nicht auf den Textkörper der Nachricht zugreifen.

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 Message zu testde Test.

Gibt zurück

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

Ausnahmen

message ist null.

Die XPath-Auswertung hat versucht, den Textkörper der Nachricht zu untersuchen.

Es ist ein Compilerfehler aufgetreten.

Hinweise

Verwenden Sie die XPathMessageFilter.Match Methode, um Elemente aus dem Textkörper abzugleichen. Eine Ausnahme wird von dieser Methode ausgelöst, wenn das Modul versucht, auf den Nachrichtentext zuzugreifen, um den XPath-Ausdruck auszuwerten. Dadurch wird sichergestellt, dass das Filtermodul nicht auf den Textstrom zugreift.

Gilt für:

Match(MessageBuffer)

Bestimmt, 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 MessageBuffer zu testde Test.

Gibt zurück

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

Ausnahmen

message ist null.

Es ist ein Compilerfehler aufgetreten.

Hinweise

Verwenden Sie diese Überladung der Match Methode, wenn eine MessageBuffer verfügbar ist. Dieses Formular darf den Textkörper der Nachricht untersuchen.

Gilt für:

Match(SeekableXPathNavigator)

Bestimmt, ob das vom 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

Die SeekableXPathNavigator Daten, die getestet werden sollen.

Gibt zurück

truewenn die Daten aus den SeekableXPathNavigator Filterkriterien entsprechen; andernfalls . false

Ausnahmen

navigator ist null.

Es ist ein Compilerfehler aufgetreten.

Hinweise

Die SeekableXPathNavigator Klasse erweitert die XPathNavigator Klasse mit Methoden, mit denen Abfragen effizienter ausgeführt werden.

Gilt für:

Match(XPathNavigator)

Wertet den Filter über den angegebenen XPath-Navigator 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

Die XPathNavigator Daten, die getestet werden sollen.

Gibt zurück

true wenn die Daten aus den XPathNavigator Filterkriterien entsprechen; false andernfalls.

Ausnahmen

navigator ist null.

Es ist ein Compilerfehler aufgetreten.

Gilt für: