XPathMessageFilter.Match メソッド

定義

名前空間:

System.ServiceModel.Dispatcher

アセンブリ:

System.ServiceModel.dll

メッセージまたは 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。

戻り値

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

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