共用方式為


XPathMessageFilter.Match 方法

定義

判斷訊息或 XML 文件是否符合 XPath 篩選條件的查詢準則。

多載

Match(Message)

測試指定的訊息是否符合 XPath 篩選條件的準則。 這種表單不可以存取訊息的本文。

Match(MessageBuffer)

判斷經緩衝處理的訊息是否符合 XPath 篩選條件的查詢準則。

Match(SeekableXPathNavigator)

判斷由已指定最佳化 XPath 導覽所提供的 XML 文件是否符合 XPath 篩選條件的查詢準則。

Match(XPathNavigator)

評估已指定 XPath 導覽的篩選。

備註

這些方法會針對一個篩選條件來檢查訊息。 如果您需要針對多個篩選條件來檢查訊息,請將篩選條件放入篩選資料表,然後使用資料表所提供的比對方法。

如果您只需要測試訊息標頭而不用測試訊息本文,請使用 Match 方法。

如果您需要測試訊息本文的部分內容,請使用 Match 方法。

對於包含 XPath 查詢的測試,請使用其中一種剩餘的 Match 多載。

Match(Message)

測試指定的訊息是否符合 XPath 篩選條件的準則。 這種表單不可以存取訊息的本文。

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

參數

message
Message

要測試的 Message

傳回

如果 Message 符合篩選條件準則,則為 true,否則為 false

例外狀況

messagenull

XPath 評估已嘗試檢查訊息的本文。

發生編譯器錯誤。

備註

請使用 XPathMessageFilter.Match 方法來比對本文中的項目。 如果引擎嘗試存取訊息本文以便評估 XPath 運算式,這個方法便會擲回例外狀況。 這樣有助於確保篩選引擎不會存取本文資料流。

適用於

Match(MessageBuffer)

判斷經緩衝處理的訊息是否符合 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

參數

messageBuffer
MessageBuffer

要測試的 MessageBuffer

傳回

如果 Match(MessageBuffer) 符合篩選條件準則,則為 true,否則為 false

例外狀況

messagenull

發生編譯器錯誤。

備註

如果可以使用 Match,便可使用這個 MessageBuffer 方法多載。 這種表單可以檢查訊息的本文。

適用於

Match(SeekableXPathNavigator)

判斷由已指定最佳化 XPath 導覽所提供的 XML 文件是否符合 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

參數

navigator
SeekableXPathNavigator

提供要測試之資料的 SeekableXPathNavigator

傳回

如果來自 true 的資料符合篩選條件準則,則為 SeekableXPathNavigator,否則為 false

例外狀況

navigatornull

發生編譯器錯誤。

備註

SeekableXPathNavigator 類別會以更有效率地執行查詢的方法來擴充 XPathNavigator 類別。

適用於

Match(XPathNavigator)

評估已指定 XPath 導覽的篩選。

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

參數

navigator
XPathNavigator

提供要測試之資料的 XPathNavigator

傳回

如果來自 XPathNavigator 的資料符合篩選條件準則,則為 true,否則為 false

例外狀況

navigatornull

發生編譯器錯誤。

適用於