次の方法で共有


XPathMessageFilterTable<TFilterData>.GetMatchingValue メソッド

定義

指定したドキュメント オブジェクトがテーブルのただ 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

実装

例外

messagenullです。

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

実装

例外

messagenullです。

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

例外

navigatornullです。

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

例外

navigatornullです。

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

注釈

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

適用対象