MessageFilterTable<TFilterData>.GetMatchingValues Method

Definition

Namespace:

System.ServiceModel.Dispatcher

Assembly:

System.ServiceModel.dll

Returns a value that indicates whether the match criterion of at least one filter in the table is satisfied by the specified message or buffered message and adds the FilterData of the matching filters to a collection.

Overloads

GetMatchingValues(Message, ICollection<TFilterData>)	Returns a value that indicates whether the match criterion of at least one filter in the table is satisfied by the specified message or buffered message and adds the FilterData of the matching filters to a collection.
GetMatchingValues(MessageBuffer, ICollection<TFilterData>)	Returns a value that indicates whether the match criterion of exactly one filter in the table is satisfied by the specified message buffer and adds the FilterData of the matching filters to the results collection.

Remarks

Use this method when more than one filter is expected to match the message or buffered message and only the FilterData is required.

GetMatchingValues(Message, ICollection<TFilterData>)

Returns a value that indicates whether the match criterion of at least one filter in the table is satisfied by the specified message or buffered message and adds the FilterData of the matching filters to a collection.

public:
 virtual 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
override this.GetMatchingValues : System.ServiceModel.Channels.Message * System.Collections.Generic.ICollection<'FilterData> -> bool

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

Parameters

message

Message

The Message to test.

results

ICollection<TFilterData>

The reference parameter that stores the FilterData of the matching action filters in a generic ICollection<T><FilterData>.

Returns

Boolean

true if match criterion of exactly one filter in the table is satisfied by the message; false if no filter is satisfied.

Implements

GetMatchingValues(Message, ICollection<TFilterData>)

Exceptions

ArgumentNullException

results is null.

InvalidBodyAccessException

A filter attempted to examine the contents of the message body.

Remarks

Use this method when more than one filter is expected to match the message, only the FilterData is required, and the body of the message is not inspected.

The FilterData of the matching MessageFilter objects are stored in the results parameter of ICollection<T>.

This method implements GetMatchingValues.

GetMatchingValues(MessageBuffer, ICollection<TFilterData>)

Returns a value that indicates whether the match criterion of exactly one filter in the table is satisfied by the specified message buffer and adds the FilterData of the matching filters to the results collection.

public:
 virtual bool GetMatchingValues(System::ServiceModel::Channels::MessageBuffer ^ buffer, 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
override this.GetMatchingValues : System.ServiceModel.Channels.MessageBuffer * System.Collections.Generic.ICollection<'FilterData> -> bool

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

Parameters

buffer

MessageBuffer

The MessageBuffer to test.

results

ICollection<TFilterData>

The reference parameter that stores the filter data of the filters that are satisfied by the buffer.

Returns

Boolean

true if the match criterion of exactly one ActionMessageFilter in the table is satisfied by the buffered message; false if no filter is satisfied.

Implements

GetMatchingValues(MessageBuffer, ICollection<TFilterData>)

Exceptions

ArgumentNullException

results is null.

Remarks

Use this method when more than one filter is expected to match the buffered message and only the FilterData is required.

The FilterData of the matching MessageFilter objects are stored in the results ICollection<T>.

This method implements GetMatchingValues.