XPathMessageFilterTable<TFilterData>.GetMatchingFilter メソッド

定義

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

オーバーロード

GetMatchingFilter(Message, MessageFilter)

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

GetMatchingFilter(MessageBuffer, MessageFilter)

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

GetMatchingFilter(SeekableXPathNavigator, MessageFilter)

指定されたメッセージまたはバッファー内のメッセージがテーブル内のただ 1 つの SeekableXPathNavigator の一致条件を満たしているかどうかを示す値を返し、そのフィルターを out パラメーターに設定して返します。Returns a value that indicates whether the match criterion of exactly one SeekableXPathNavigator in the table is satisfied by the specified message or buffered message and returns that filter in an out parameter.

GetMatchingFilter(XPathNavigator, MessageFilter)

指定されたメッセージまたはバッファー内のメッセージがテーブル内のただ 1 つの XPathNavigator の一致条件を満たしているかどうかを示す値を返し、そのフィルターを out パラメーターに設定して返します。Returns a value that indicates whether the match criterion of exactly one XPathNavigator in the table is satisfied by the specified message or buffered message and returns that filter in an out parameter.

注釈

メッセージがフィルター テーブル内のいずれか 1 つだけのフィルター条件を満たしているかどうかをテストします。Tests whether a message satisfies exactly one of the filters in the filter table.

GetMatchingFilter(Message, MessageFilter)

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

public:
 virtual bool GetMatchingFilter(System::ServiceModel::Channels::Message ^ message, [Runtime::InteropServices::Out] System::ServiceModel::Dispatcher::MessageFilter ^ % filter);
public bool GetMatchingFilter (System.ServiceModel.Channels.Message message, out System.ServiceModel.Dispatcher.MessageFilter filter);
abstract member GetMatchingFilter : System.ServiceModel.Channels.Message * MessageFilter -> bool
override this.GetMatchingFilter : System.ServiceModel.Channels.Message * MessageFilter -> bool
Public Function GetMatchingFilter (message As Message, ByRef filter As MessageFilter) As Boolean

パラメーター

message
Message

テスト対象の MessageThe Message to test.

filter
MessageFilter

out が満たすフィルター条件が格納される message パラメーター。The out parameter that stores the filter that is satisfied by the message. フィルターが見つからなかった場合は、このパラメーターに既定値が設定されます。If no filter was found, the parameter is set to its default value.

戻り値

Boolean

メッセージによってクエリ条件が満たされている MessageFilter。条件を満たすフィルターが見つからない場合は nullThe MessageFilter whose query criteria are satisfied by the message; or null if no filters are found to match.

実装

例外

messagenullです。message is null.

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

フィルターがメッセージ本文の内容を検査しようとしました。A filter attempted to examine the contents of the message body.

注釈

1 つのフィルターがメッセージに一致すると推測され、一致するフィルターが必要な場合に、このメソッドを使用します。Use this method when a single filter is expected to match the message and the matching filter is required.

このメソッドは、優先度の最も高いフィルター グループ内で一致するフィルターが 1 つだけ存在するかどうかをテストします。This method tests for a single filter match in the highest priority bucket of filters. テーブル内のフィルターは、メッセージ本文を検査できません。The filters in the table are not allowed to inspect the message body.

2 つ以上のフィルタがメッセージに一致すると予測される場合は、GetMatchingFilters を使用します。If more than one filter is expected to match the message, use the GetMatchingFilters.

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

適用対象

GetMatchingFilter(MessageBuffer, MessageFilter)

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

public:
 virtual bool GetMatchingFilter(System::ServiceModel::Channels::MessageBuffer ^ messageBuffer, [Runtime::InteropServices::Out] System::ServiceModel::Dispatcher::MessageFilter ^ % filter);
public bool GetMatchingFilter (System.ServiceModel.Channels.MessageBuffer messageBuffer, out System.ServiceModel.Dispatcher.MessageFilter filter);
abstract member GetMatchingFilter : System.ServiceModel.Channels.MessageBuffer * MessageFilter -> bool
override this.GetMatchingFilter : System.ServiceModel.Channels.MessageBuffer * MessageFilter -> bool
Public Function GetMatchingFilter (messageBuffer As MessageBuffer, ByRef filter As MessageFilter) As Boolean

パラメーター

messageBuffer
MessageBuffer

テスト対象の MessageBufferThe MessageBuffer to test.

filter
MessageFilter

out が満たすフィルター条件が格納される message パラメーター。The out parameter that stores the filter that is satisfied by the message. フィルターが見つからなかった場合は、このパラメーターに既定値が設定されます。If no filter was found, the parameter is set to its default value.

戻り値

Boolean

バッファー内のメッセージによってクエリ条件が満たされている MessageFilter。条件を満たすフィルターが見つからない場合は nullThe MessageFilter whose query criteria are satisfied by the buffered message; or null if no filters are found to match.

実装

例外

messageBuffernullです。messageBuffer is null.

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

注釈

1 つのフィルターがバッファー内のメッセージに一致すると推測され、一致するフィルターが必要な場合に、このメソッドを使用します。Use this method when a single filter is expected to match the buffered message and the matching filter is required.

テーブル内のフィルターは、メッセージ本文を検査できます。The filters in the table are allowed to inspect the message body.

2 つ以上のフィルタがメッセージに一致すると予測される場合は、GetMatchingFilters を使用します。If more than one filter is expected to match the message, use the GetMatchingFilters.

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

適用対象

GetMatchingFilter(SeekableXPathNavigator, MessageFilter)

指定されたメッセージまたはバッファー内のメッセージがテーブル内のただ 1 つの SeekableXPathNavigator の一致条件を満たしているかどうかを示す値を返し、そのフィルターを out パラメーターに設定して返します。Returns a value that indicates whether the match criterion of exactly one SeekableXPathNavigator in the table is satisfied by the specified message or buffered message and returns that filter in an out parameter.

public:
 bool GetMatchingFilter(System::ServiceModel::Dispatcher::SeekableXPathNavigator ^ navigator, [Runtime::InteropServices::Out] System::ServiceModel::Dispatcher::MessageFilter ^ % filter);
public bool GetMatchingFilter (System.ServiceModel.Dispatcher.SeekableXPathNavigator navigator, out System.ServiceModel.Dispatcher.MessageFilter filter);
member this.GetMatchingFilter : System.ServiceModel.Dispatcher.SeekableXPathNavigator * MessageFilter -> bool
Public Function GetMatchingFilter (navigator As SeekableXPathNavigator, ByRef filter As MessageFilter) As Boolean

パラメーター

navigator
SeekableXPathNavigator

テスト対象の SeekableXPathNavigatorThe SeekableXPathNavigator to test.

filter
MessageFilter

out が満たすフィルター条件が格納される message パラメーター。The out parameter that stores the filter that is satisfied by the message. フィルターが見つからなかった場合は、このパラメーターに既定値が設定されます。If no filter was found, the parameter is set to its default value.

戻り値

Boolean

ナビゲーターによってクエリ条件が満たされている MessageFilter。条件を満たすフィルターが見つからない場合は nullThe MessageFilter whose query criteria are satisfied by the navigator; or null if no filters are found to match.

例外

navigatornullです。navigator is null.

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

注釈

1 つのフィルターが SeekableXPathNavigator によって指定されたメッセージに一致すると推測され、一致するフィルターが必要な場合に、このメソッドを使用します。Use this method when a single filter is expected to match the message specified by the SeekableXPathNavigator and the matching filter is required.

2 つ以上のフィルタがメッセージに一致すると予測される場合は、GetMatchingFilters を使用します。If more than one filter is expected to match the message, use the GetMatchingFilters.

適用対象

GetMatchingFilter(XPathNavigator, MessageFilter)

指定されたメッセージまたはバッファー内のメッセージがテーブル内のただ 1 つの XPathNavigator の一致条件を満たしているかどうかを示す値を返し、そのフィルターを out パラメーターに設定して返します。Returns a value that indicates whether the match criterion of exactly one XPathNavigator in the table is satisfied by the specified message or buffered message and returns that filter in an out parameter.

public:
 bool GetMatchingFilter(System::Xml::XPath::XPathNavigator ^ navigator, [Runtime::InteropServices::Out] System::ServiceModel::Dispatcher::MessageFilter ^ % filter);
public bool GetMatchingFilter (System.Xml.XPath.XPathNavigator navigator, out System.ServiceModel.Dispatcher.MessageFilter filter);
member this.GetMatchingFilter : System.Xml.XPath.XPathNavigator * MessageFilter -> bool
Public Function GetMatchingFilter (navigator As XPathNavigator, ByRef filter As MessageFilter) As Boolean

パラメーター

navigator
XPathNavigator

テスト対象の XPathNavigatorThe XPathNavigator to test.

filter
MessageFilter

out が満たすフィルター条件が格納される navigator パラメーター。The out parameter that stores the filter that is satisfied by the navigator. フィルターが見つからなかった場合は、このパラメーターに既定値が設定されます。If no filter was found, the parameter is set to its default value.

戻り値

Boolean

ナビゲーターによってクエリ条件が満たされている MessageFilter。条件を満たすフィルターが見つからない場合は nullThe MessageFilter whose query criteria are satisfied by the navigator; or null if no filters are found to match.

例外

navigatornullです。navigator is null.

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

注釈

1 つのフィルターが XPathNavigator によって指定されたメッセージに一致すると推測され、一致するフィルターが必要な場合に、このメソッドを使用します。Use this method when a single filter is expected to match the message specified by the XPathNavigator and the matching filter is required.

2 つ以上のフィルタがメッセージに一致すると予測される場合は、GetMatchingFilters を使用します。If more than one filter is expected to match the message, use the GetMatchingFilters.

適用対象