次の方法で共有


XPathMessageFilter.Match メソッド

定義

メッセージまたは XML ドキュメントが XPath フィルターのクエリ条件を満たすかどうかを判定します。

オーバーロード

Match(Message)

指定したメッセージが XPath フィルターの条件を満たすかどうかを検査します。 この形式では、メッセージの本文にはアクセスできません。

Match(MessageBuffer)

バッファー内のメッセージが XPath フィルターのクエリ条件を満たすかどうかを判定します。

Match(SeekableXPathNavigator)

指定した最適化済みの XPath ナビゲーターによって提供される XML ドキュメントが XPath フィルターのクエリ条件を満たすかどうかを判定します。

Match(XPathNavigator)

指定した XPath ナビゲーターについてフィルターを評価します。

注釈

これらのメソッドは、特定のメッセージを 1 つのフィルターでチェックします。 特定のメッセージを複数のフィルターでチェックする必要がある場合は、それらのフィルターをフィルター テーブルに登録して、同テーブルによって提供されているチェック用メソッドを使用します。

メッセージ本文ではなくメッセージ ヘッダーだけを判定すればよい場合は、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です。

コンパイル エラーが発生しました。

適用対象