XPathMessageFilterTable<TFilterData>.GetMatchingValue メソッド

定義

指定したドキュメント オブジェクトがテーブルのただ 1 つの XPathMessageFilter の一致条件を満たしているかどうかを示す値を返し、一致するフィルターのデータをコレクションに追加します。Returns a value that indicates whether the match criterion of exactly one XPathMessageFilter in the table is satisfied by the specified document object and adds the matching filter data to a collection.

オーバーロード

GetMatchingValue(Message, TFilterData)

指定したメッセージがテーブルのただ 1 つの XPathMessageFilter の一致条件を満たしているかどうかを示す値を返し、一致するフィルターのデータを返します。Returns a value that indicates whether the match criterion of exactly one XPathMessageFilter in the table is satisfied by the specified message and returns the matching filter data.

GetMatchingValue(MessageBuffer, TFilterData)

指定したバッファー内のメッセージがテーブル内のただ 1 つの XPathMessageFilter の一致条件を満たしているかどうかを示す値を返し、一致するフィルターのデータを返します。Returns a value that indicates whether the match criterion of exactly one XPathMessageFilter in the table is satisfied by the specified buffered message and returns the matching filter data.

GetMatchingValue(SeekableXPathNavigator, TFilterData)

SeekableXPathNavigator がテーブル内のただ 1 つの navigator の一致条件を満たしているかどうかを示す値を返し、一致するフィルターのフィルター データを out パラメーターに設定して返します。Returns a value that indicates whether the match criterion of exactly one SeekableXPathNavigator in the table is satisfied by the navigator and returns the filter data of the matching filter in an out parameter.

GetMatchingValue(XPathNavigator, TFilterData)

XPathNavigator がテーブル内のただ 1 つの navigator の一致条件を満たしているかどうかを示す値を返し、一致するフィルターのフィルター データを out パラメーターに設定して返します。Returns a value that indicates whether the match criterion of exactly one XPathNavigator in the table is satisfied by the navigator and returns the filter data of the matching filter in an out parameter.

注釈

1 つのフィルターがドキュメント オブジェクトに一致すると予測され、一致するフィルターから FilterData だけを復元する必要がある場合は、次の 4 つのメソッドのいずれか 1 つを使用します。Use one of these four methods when a single filter is expected to match the document object and only the FilterData from the matching filter must be recovered.

最初の2つのメソッドは、の実装 GetMatchingValue です。The first two methods are implementations of GetMatchingValue.

メッセージ本文の内容を調べる必要がない場合は、GetMatchingValue を使用します。Use GetMatchingValue if the body content does not require examination. メッセージ本文の内容を調べる必要がある場合は、GetMatchingValue を使用します。Use GetMatchingValue if the contents of the message body may require examination.

残りの 2 つのメソッドは、XPathMessageFilterTable<TFilterData> 固有のオーバーロードです。The remaining two methods are overloads specific to XPathMessageFilterTable<TFilterData>. ナビゲーターを介して提供されたドキュメントに対してフィルター処理を実行するには、GetMatchingValue または GetMatchingValue を使用します。To filter on a document provided through a navigator, use GetMatchingValue or GetMatchingValue.

GetMatchingValue(Message, TFilterData)

指定したメッセージがテーブルのただ 1 つの XPathMessageFilter の一致条件を満たしているかどうかを示す値を返し、一致するフィルターのデータを返します。Returns a value that indicates whether the match criterion of exactly one XPathMessageFilter in the table is satisfied by the specified message and returns the matching filter data.

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

テスト対象の MessageThe Message to test.

data
TFilterData

message に一致するフィルターの FilterData が格納される out パラメーター。The out parameter that stores the FilterData for the filter that matches the message.

戻り値

Boolean

メッセージがテーブル内のいずれか 1 つのフィルターの一致条件を満たしている場合は true、どのフィルター条件も満たしていない場合は falsetrue if the match criterion of one filter in the table is satisfied by the message; false if no filter is satisfied.

実装

例外

messagenullです。message is null.

2 つ以上のフィルターが message に一致しています。More than one filter matches the message.

注釈

1 つのフィルターがメッセージに一致すると予測され、一致するフィルターから FilterData だけを復元する必要がある場合は、このメソッドを使用します。Use this method when a single filter is expected to match the message and only the FilterData from the matching filter must be recovered.

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

適用対象

GetMatchingValue(MessageBuffer, TFilterData)

指定したバッファー内のメッセージがテーブル内のただ 1 つの XPathMessageFilter の一致条件を満たしているかどうかを示す値を返し、一致するフィルターのデータを返します。Returns a value that indicates whether the match criterion of exactly one XPathMessageFilter in the table is satisfied by the specified buffered message and returns the matching filter data.

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

テスト対象の MessageBufferThe MessageBuffer to test.

data
TFilterData

messageBuffer に一致するフィルターの FilterData が格納される out パラメーター。The out parameter that stores the FilterData for the filter that matches the messageBuffer.

戻り値

Boolean

バッファー内のメッセージがテーブル内のいずれか 1 つのフィルターの一致条件を満たしている場合は true、どのフィルター条件も満たしていない場合は falsetrue if the match criterion of one filter in the table is satisfied by the buffered message; false if no filter is satisfied.

実装

例外

messagenullです。message is null.

2 つ以上のフィルターが messageBuffer に一致しています。More than one filter matches the messageBuffer.

注釈

1 つのフィルターがバッファー内のメッセージに一致すると予測され、一致するフィルターから FilterData だけを復元する必要がある場合は、このメソッドを使用します。Use this method when a single filter is expected to match the buffered message and only the FilterData from the matching filter must be recovered.

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

適用対象

GetMatchingValue(SeekableXPathNavigator, TFilterData)

SeekableXPathNavigator がテーブル内のただ 1 つの navigator の一致条件を満たしているかどうかを示す値を返し、一致するフィルターのフィルター データを out パラメーターに設定して返します。Returns a value that indicates whether the match criterion of exactly one SeekableXPathNavigator in the table is satisfied by the navigator and returns the filter data of the matching filter in an out parameter.

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

テスト対象の SeekableXPathNavigatorThe SeekableXPathNavigator to test.

data
TFilterData

navigator に一致する FilterData が格納される out パラメーター。The out parameter that stores the FilterData that matches the navigator.

戻り値

Boolean

navigator がテーブル内のいずれか 1 つだけのフィルターの一致条件を満たしている場合は true、どのフィルター条件も満たしていない場合は falsetrue if the match criterion of exactly one filter in the table is satisfied by the navigator; false if no filter is satisfied.

例外

navigatornullです。navigator is null.

2 つ以上のフィルターが navigator に一致しています。More than one filter matches the navigator.

注釈

このメソッドは、メッセージが満たす必要のある XPath 条件を指定するために使用します。Use this method to specify an XPath condition that the message must meet.

このメソッドは GetMatchingValue と似ていますが、SeekableXPathNavigator を使用する点が異なります。これは、さまざまな最適化を可能にするメソッドを含むように、XPathNavigator の機能を拡張したものです。This method is similar to GetMatchingValue, except that it uses a SeekableXPathNavigator, which extends the functionality of the XPathNavigator to include methods that allow various optimizations.

適用対象

GetMatchingValue(XPathNavigator, TFilterData)

XPathNavigator がテーブル内のただ 1 つの navigator の一致条件を満たしているかどうかを示す値を返し、一致するフィルターのフィルター データを out パラメーターに設定して返します。Returns a value that indicates whether the match criterion of exactly one XPathNavigator in the table is satisfied by the navigator and returns the filter data of the matching filter in an out parameter.

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

テスト対象の XPathNavigatorThe XPathNavigator to test.

data
TFilterData

navigator に一致する FilterData が格納される out パラメーター。The out parameter that stores the FilterData that matches the navigator.

戻り値

Boolean

navigator がテーブル内のいずれか 1 つだけのフィルターの一致条件を満たしている場合は true、どのフィルター条件も満たしていない場合は falsetrue if the match criterion of exactly one filter in the table is satisfied by the navigator; false if no filter is satisfied.

例外

navigatornullです。navigator is null.

2 つ以上のフィルターが navigator に一致しています。More than one filter matches the navigator.

注釈

このメソッドは、メッセージが満たす必要のある XPath 条件を指定するために使用します。Use this method to specify an XPath condition that the message must meet.

適用対象