XPathMessageFilter.Match Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
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.