IMessageFilterTable<TFilterData>.GetMatchingValues メソッド

定義

名前空間:

System.ServiceModel.Dispatcher

アセンブリ:

System.ServiceModel.dll

指定したメッセージまたはバッファー内のメッセージと一致するフィルターのフィルター データを、コレクションに追加します。

オーバーロード

GetMatchingValues(Message, ICollection<TFilterData>)	指定したメッセージがテーブル内の少なくとも 1 つのフィルターの一致条件を満たしているかどうかを示す値を返し、一致するフィルターの FilterData をコレクションに追加します。
GetMatchingValues(MessageBuffer, ICollection<TFilterData>)	指定したバッファー内のメッセージがテーブル内の少なくとも 1 つのフィルターの一致条件を満たしているかどうかを示す値を返し、一致するフィルターの FilterData をコレクションに追加します。

注釈

2 つ以上のフィルターがメッセージに一致すると推測され、一致するフィルター データだけが必要な場合は、このメソッドを使用します。 これらのメソッドは、一致するフィルターが見つかったかどうかを示すブール値を返し、一致するフィルター データをすべてコレクションに格納します。

結果を追加する前に、フィルターが格納されたコレクションをクリアしないように注意してください。 そうすることで、複数のフィルター テーブルに含まれる一致フィルターのすべてを 1 つのコレクションに蓄積できます。

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

GetMatchingValues(Message, ICollection<TFilterData>)

指定したメッセージがテーブル内の少なくとも 1 つのフィルターの一致条件を満たしているかどうかを示す値を返し、一致するフィルターの FilterData をコレクションに追加します。

public:
 bool GetMatchingValues(System::ServiceModel::Channels::Message ^ message, System::Collections::Generic::ICollection<TFilterData> ^ results);

public bool GetMatchingValues (System.ServiceModel.Channels.Message message, System.Collections.Generic.ICollection<TFilterData> results);

abstract member GetMatchingValues : System.ServiceModel.Channels.Message * System.Collections.Generic.ICollection<'FilterData> -> bool

Public Function GetMatchingValues (message As Message, results As ICollection(Of TFilterData)) As Boolean

パラメーター

message

Message

テスト対象の Message。

results

ICollection<TFilterData>

一致するフィルターのフィルター データをジェネリック コレクションに格納する参照パラメーター。

戻り値

Boolean

true がテーブル内の少なくとも 1 つのフィルターの一致条件を満たしている場合は message、どのフィルター条件も満たしていない場合は false。

注釈

1 つ以上のフィルターがメッセージに一致すると予測され、フィルター データだけが必要で、メッセージ本文の内容を検査しない場合は、このメソッドを使用します。

一致する MessageFilter オブジェクトのフィルター データを results パラメーターに格納します。

フィルター テーブル内のフィルターでメッセージの本文を検査する場合は、メッセージをバッファーに格納し、それを GetMatchingValues バージョンのメソッドに渡します。

GetMatchingValues(MessageBuffer, ICollection<TFilterData>)

指定したバッファー内のメッセージがテーブル内の少なくとも 1 つのフィルターの一致条件を満たしているかどうかを示す値を返し、一致するフィルターの FilterData をコレクションに追加します。

public:
 bool GetMatchingValues(System::ServiceModel::Channels::MessageBuffer ^ messageBuffer, System::Collections::Generic::ICollection<TFilterData> ^ results);

public:
 bool GetMatchingValues(System::ServiceModel::Channels::MessageBuffer ^ buffer, System::Collections::Generic::ICollection<TFilterData> ^ results);

public bool GetMatchingValues (System.ServiceModel.Channels.MessageBuffer messageBuffer, System.Collections.Generic.ICollection<TFilterData> results);

public bool GetMatchingValues (System.ServiceModel.Channels.MessageBuffer buffer, System.Collections.Generic.ICollection<TFilterData> results);

abstract member GetMatchingValues : System.ServiceModel.Channels.MessageBuffer * System.Collections.Generic.ICollection<'FilterData> -> bool

abstract member GetMatchingValues : System.ServiceModel.Channels.MessageBuffer * System.Collections.Generic.ICollection<'FilterData> -> bool

Public Function GetMatchingValues (messageBuffer As MessageBuffer, results As ICollection(Of TFilterData)) As Boolean

Public Function GetMatchingValues (buffer As MessageBuffer, results As ICollection(Of TFilterData)) As Boolean

パラメーター

messageBufferbuffer

MessageBuffer

テスト対象の MessageBuffer。

results

ICollection<TFilterData>

一致するフィルターのフィルター データをジェネリック ICollection<T><FilterData> に格納する参照パラメーター。

戻り値

Boolean

true がテーブル内の少なくとも 1 つのフィルターの一致条件を満たしている場合は messageBuffer、どのフィルター条件も満たしていない場合は false。

注釈

1 つ以上のフィルターがバッファー内のメッセージに一致すると予測され、フィルター データだけが必要で、メッセージ本文の検査が必要になる可能性がある場合は、このメソッドを使用します。

一致する MessageFilter オブジェクトのフィルター データを results パラメーターに格納します。