XPathMessageFilterTable<TFilterData>.GetMatchingValue メソッド

定義

名前空間:

System.ServiceModel.Dispatcher

アセンブリ:

System.ServiceModel.dll

指定したドキュメント オブジェクトがテーブルのただ 1 つの XPathMessageFilter の一致条件を満たしているかどうかを示す値を返し、一致するフィルターのデータをコレクションに追加します。

オーバーロード

GetMatchingValue(Message, TFilterData)	指定したメッセージがテーブルのただ 1 つの XPathMessageFilter の一致条件を満たしているかどうかを示す値を返し、一致するフィルターのデータを返します。
GetMatchingValue(MessageBuffer, TFilterData)	指定したバッファー内のメッセージがテーブル内のただ 1 つの XPathMessageFilter の一致条件を満たしているかどうかを示す値を返し、一致するフィルターのデータを返します。
GetMatchingValue(SeekableXPathNavigator, TFilterData)	SeekableXPathNavigator がテーブル内のただ 1 つの navigator の一致条件を満たしているかどうかを示す値を返し、一致するフィルターのフィルター データを out パラメーターに設定して返します。
GetMatchingValue(XPathNavigator, TFilterData)	XPathNavigator がテーブル内のただ 1 つの navigator の一致条件を満たしているかどうかを示す値を返し、一致するフィルターのフィルター データを out パラメーターに設定して返します。

注釈

1 つのフィルターがドキュメント オブジェクトに一致すると予測され、一致するフィルターから FilterData だけを復元する必要がある場合は、次の 4 つのメソッドのいずれか 1 つを使用します。

最初の 2 つのメソッドは、 GetMatchingValue.

メッセージ本文の内容を調べる必要がない場合は、GetMatchingValue を使用します。 メッセージ本文の内容を調べる必要がある場合は、GetMatchingValue を使用します。

残りの 2 つのメソッドは、XPathMessageFilterTable<TFilterData> 固有のオーバーロードです。 ナビゲーターを介して提供されたドキュメントに対してフィルター処理を実行するには、GetMatchingValue または GetMatchingValue を使用します。

GetMatchingValue(Message, TFilterData)

指定したメッセージがテーブルのただ 1 つの XPathMessageFilter の一致条件を満たしているかどうかを示す値を返し、一致するフィルターのデータを返します。

public:
 virtual bool GetMatchingValue(System::ServiceModel::Channels::Message ^ message, [Runtime::InteropServices::Out] TFilterData % data);

public bool GetMatchingValue (System.ServiceModel.Channels.Message message, out TFilterData data);

abstract member GetMatchingValue : System.ServiceModel.Channels.Message * 'FilterData -> bool
override this.GetMatchingValue : System.ServiceModel.Channels.Message * 'FilterData -> bool

Public Function GetMatchingValue (message As Message, ByRef data As TFilterData) As Boolean

パラメーター

message

Message

テスト対象の Message。

data

TFilterData

message に一致するフィルターの FilterData が格納される out パラメーター。

戻り値

Boolean

メッセージがテーブル内のいずれか 1 つのフィルターの一致条件を満たしている場合は true、どのフィルター条件も満たしていない場合は false。

実装

GetMatchingValue(Message, TFilterData)

例外

ArgumentNullException

message が nullです。

MultipleFilterMatchesException

2 つ以上のフィルターが message に一致しています。

注釈

1 つのフィルターがメッセージに一致すると予測され、一致するフィルターから FilterData だけを復元する必要がある場合は、このメソッドを使用します。

このメソッドは、GetMatchingValue を実装します。

GetMatchingValue(MessageBuffer, TFilterData)

指定したバッファー内のメッセージがテーブル内のただ 1 つの XPathMessageFilter の一致条件を満たしているかどうかを示す値を返し、一致するフィルターのデータを返します。

public:
 virtual bool GetMatchingValue(System::ServiceModel::Channels::MessageBuffer ^ messageBuffer, [Runtime::InteropServices::Out] TFilterData % data);

public bool GetMatchingValue (System.ServiceModel.Channels.MessageBuffer messageBuffer, out TFilterData data);

abstract member GetMatchingValue : System.ServiceModel.Channels.MessageBuffer * 'FilterData -> bool
override this.GetMatchingValue : System.ServiceModel.Channels.MessageBuffer * 'FilterData -> bool

Public Function GetMatchingValue (messageBuffer As MessageBuffer, ByRef data As TFilterData) As Boolean

パラメーター

messageBuffer

MessageBuffer

テスト対象の MessageBuffer。

data

TFilterData

messageBuffer に一致するフィルターの FilterData が格納される out パラメーター。

戻り値

Boolean

バッファー内のメッセージがテーブル内のいずれか 1 つのフィルターの一致条件を満たしている場合は true、どのフィルター条件も満たしていない場合は false。

実装

GetMatchingValue(MessageBuffer, TFilterData)

例外

ArgumentNullException

message が nullです。

MultipleFilterMatchesException

2 つ以上のフィルターが messageBuffer に一致しています。

注釈

1 つのフィルターがバッファー内のメッセージに一致すると予測され、一致するフィルターから FilterData だけを復元する必要がある場合は、このメソッドを使用します。

このメソッドは、GetMatchingFilter を実装します。

GetMatchingValue(SeekableXPathNavigator, TFilterData)

SeekableXPathNavigator がテーブル内のただ 1 つの navigator の一致条件を満たしているかどうかを示す値を返し、一致するフィルターのフィルター データを out パラメーターに設定して返します。

public:
 bool GetMatchingValue(System::ServiceModel::Dispatcher::SeekableXPathNavigator ^ navigator, [Runtime::InteropServices::Out] TFilterData % data);

public bool GetMatchingValue (System.ServiceModel.Dispatcher.SeekableXPathNavigator navigator, out TFilterData data);

member this.GetMatchingValue : System.ServiceModel.Dispatcher.SeekableXPathNavigator * 'FilterData -> bool

Public Function GetMatchingValue (navigator As SeekableXPathNavigator, ByRef data As TFilterData) As Boolean

パラメーター

navigator

SeekableXPathNavigator

テスト対象の SeekableXPathNavigator。

data

TFilterData

navigator に一致する FilterData が格納される out パラメーター。

戻り値

Boolean

navigator がテーブル内のいずれか 1 つだけのフィルターの一致条件を満たしている場合は true、どのフィルター条件も満たしていない場合は false。

例外

ArgumentNullException

navigator が nullです。

MultipleFilterMatchesException

2 つ以上のフィルターが navigator に一致しています。

注釈

このメソッドは、メッセージが満たす必要のある XPath 条件を指定するために使用します。

このメソッドは GetMatchingValue と似ていますが、SeekableXPathNavigator を使用する点が異なります。これは、さまざまな最適化を可能にするメソッドを含むように、XPathNavigator の機能を拡張したものです。

GetMatchingValue(XPathNavigator, TFilterData)

XPathNavigator がテーブル内のただ 1 つの navigator の一致条件を満たしているかどうかを示す値を返し、一致するフィルターのフィルター データを out パラメーターに設定して返します。

public:
 bool GetMatchingValue(System::Xml::XPath::XPathNavigator ^ navigator, [Runtime::InteropServices::Out] TFilterData % data);

public bool GetMatchingValue (System.Xml.XPath.XPathNavigator navigator, out TFilterData data);

member this.GetMatchingValue : System.Xml.XPath.XPathNavigator * 'FilterData -> bool

Public Function GetMatchingValue (navigator As XPathNavigator, ByRef data As TFilterData) As Boolean

パラメーター

navigator

XPathNavigator

テスト対象の XPathNavigator。

data

TFilterData

navigator に一致する FilterData が格納される out パラメーター。

戻り値

Boolean

navigator がテーブル内のいずれか 1 つだけのフィルターの一致条件を満たしている場合は true、どのフィルター条件も満たしていない場合は false。

例外

ArgumentNullException

navigator が nullです。

MultipleFilterMatchesException

2 つ以上のフィルターが navigator に一致しています。

注釈

このメソッドは、メッセージが満たす必要のある XPath 条件を指定するために使用します。