XPathMessageFilter.Match 方法

定義

命名空間:

System.ServiceModel.Dispatcher

組件:

System.ServiceModel.dll

判斷訊息或 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。

傳回

Boolean

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

例外狀況

ArgumentNullException

message 為 null。

InvalidBodyAccessException

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

XPathException

發生編譯器錯誤。

備註

請使用 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。

傳回

Boolean

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

例外狀況

ArgumentNullException

message 為 null。

XPathException

發生編譯器錯誤。

備註

如果可以使用 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。

傳回

Boolean

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

例外狀況

ArgumentNullException

navigator 為 null。

XPathException

發生編譯器錯誤。

備註

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。

傳回

Boolean

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

例外狀況

ArgumentNullException

navigator 為 null。

XPathException

發生編譯器錯誤。