XPathMessageFilterTable<TFilterData>.GetMatchingFilters Method

Reference

Definition

Namespace:: System.ServiceModel.Dispatcher

Assembly:: System.ServiceModel.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Returns a value that indicates whether the match criterion of a filter in the table is satisfied by the specified XML document and adds the matching filters to a collection.

Overloads

GetMatchingFilters(SeekableXPathNavigator, ICollection<MessageFilter>)	Returns a value that indicates whether the match criterion of at least one SeekableXPathNavigator in the table is satisfied by the specified buffered message and adds the matching filters to a collection.
GetMatchingFilters(XPathNavigator, ICollection<MessageFilter>)	Returns a value that indicates whether the match criterion of at least one XPathNavigator in the table is satisfied by the specified buffered message and adds the matching filters to a collection.
GetMatchingFilters(Message, ICollection<MessageFilter>)	Returns a value that indicates whether the match criterion of at least one XPathMessageFilter in the table is satisfied by the specified message and adds the matching filters to a collection.
GetMatchingFilters(MessageBuffer, ICollection<MessageFilter>)	Returns a value that indicates whether the match criterion of at least one XPathMessageFilter in the table is satisfied by the specified buffered message and adds the matching filters to a collection.

Remarks

Use this method when more than one filter is expected to match the message and the matching filters are required.

GetMatchingFilters(SeekableXPathNavigator, ICollection<MessageFilter>)

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

public:
 bool GetMatchingFilters(System::ServiceModel::Dispatcher::SeekableXPathNavigator ^ navigator, System::Collections::Generic::ICollection<System::ServiceModel::Dispatcher::MessageFilter ^> ^ results);

public bool GetMatchingFilters (System.ServiceModel.Dispatcher.SeekableXPathNavigator navigator, System.Collections.Generic.ICollection<System.ServiceModel.Dispatcher.MessageFilter> results);

member this.GetMatchingFilters : System.ServiceModel.Dispatcher.SeekableXPathNavigator * System.Collections.Generic.ICollection<System.ServiceModel.Dispatcher.MessageFilter> -> bool

Public Function GetMatchingFilters (navigator As SeekableXPathNavigator, results As ICollection(Of MessageFilter)) As Boolean

Parameters

navigator: SeekableXPathNavigator

The SeekableXPathNavigator to test.

results: ICollection<MessageFilter>

The reference parameter that stores the MessageFilter objects that match in ICollection<T><Filter>.

Returns

Boolean

true if the match criterion of at least one filter in the table is satisfied by messageBuffer; false if no filter is satisfied.

Exceptions

ArgumentNullException

navigator or results is null.

Remarks

Use this method when more than one filter is expected to match the navigator and the matching filters are required.

If only one filter is expected to match the message, use the GetMatchingFilter method.

Applies to

GetMatchingFilters(XPathNavigator, ICollection<MessageFilter>)

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

public:
 bool GetMatchingFilters(System::Xml::XPath::XPathNavigator ^ navigator, System::Collections::Generic::ICollection<System::ServiceModel::Dispatcher::MessageFilter ^> ^ results);

public bool GetMatchingFilters (System.Xml.XPath.XPathNavigator navigator, System.Collections.Generic.ICollection<System.ServiceModel.Dispatcher.MessageFilter> results);

member this.GetMatchingFilters : System.Xml.XPath.XPathNavigator * System.Collections.Generic.ICollection<System.ServiceModel.Dispatcher.MessageFilter> -> bool

Public Function GetMatchingFilters (navigator As XPathNavigator, results As ICollection(Of MessageFilter)) As Boolean

Parameters

navigator: XPathNavigator

The XPathNavigator to test.

results: ICollection<MessageFilter>

The reference parameter that stores the MessageFilter objects that match in ICollection<T><Filter>.

Returns

Boolean

true if the match criterion of at least one filter in the table is satisfied by messageBuffer; false if no filter is satisfied.

Exceptions

ArgumentNullException

navigator or results is null.

Remarks

Use this method when multiple filters can be expected to match the message specified by the XPathNavigator and the matching filters are required.

If only one filter is expected to match the message, use the GetMatchingFilter method.

Applies to

GetMatchingFilters(Message, ICollection<MessageFilter>)

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

public:
 virtual bool GetMatchingFilters(System::ServiceModel::Channels::Message ^ message, System::Collections::Generic::ICollection<System::ServiceModel::Dispatcher::MessageFilter ^> ^ results);

public bool GetMatchingFilters (System.ServiceModel.Channels.Message message, System.Collections.Generic.ICollection<System.ServiceModel.Dispatcher.MessageFilter> results);

abstract member GetMatchingFilters : System.ServiceModel.Channels.Message * System.Collections.Generic.ICollection<System.ServiceModel.Dispatcher.MessageFilter> -> bool
override this.GetMatchingFilters : System.ServiceModel.Channels.Message * System.Collections.Generic.ICollection<System.ServiceModel.Dispatcher.MessageFilter> -> bool

Public Function GetMatchingFilters (message As Message, results As ICollection(Of MessageFilter)) As Boolean

Parameters

message: Message

The Message to test.

results: ICollection<MessageFilter>

The reference parameter that stores the MessageFilter objects that match in ICollection<T><Filter>.

Returns

Boolean

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

Implements

GetMatchingFilters(Message, ICollection<MessageFilter>)

Exceptions

ArgumentNullException

message or 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 and the matching filters are required.

The filters in the table are not allowed to inspect the message body.

The matching XPathMessageFilter objects are stored in the results parameter of ICollection<T>. The FilterData can then be recovered from the filter table using these filters as keys with the methods provided by IDictionary<TKey,TValue>.

This method implements GetMatchingFilters.

Applies to

GetMatchingFilters(MessageBuffer, ICollection<MessageFilter>)

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

public:
 virtual bool GetMatchingFilters(System::ServiceModel::Channels::MessageBuffer ^ messageBuffer, System::Collections::Generic::ICollection<System::ServiceModel::Dispatcher::MessageFilter ^> ^ results);

public bool GetMatchingFilters (System.ServiceModel.Channels.MessageBuffer messageBuffer, System.Collections.Generic.ICollection<System.ServiceModel.Dispatcher.MessageFilter> results);

abstract member GetMatchingFilters : System.ServiceModel.Channels.MessageBuffer * System.Collections.Generic.ICollection<System.ServiceModel.Dispatcher.MessageFilter> -> bool
override this.GetMatchingFilters : System.ServiceModel.Channels.MessageBuffer * System.Collections.Generic.ICollection<System.ServiceModel.Dispatcher.MessageFilter> -> bool

Public Function GetMatchingFilters (messageBuffer As MessageBuffer, results As ICollection(Of MessageFilter)) As Boolean

Parameters

messageBuffer: MessageBuffer

The MessageBuffer to test.

results: ICollection<MessageFilter>

The reference parameter that stores the MessageFilter objects that match in ICollection<T><Filter>.

Returns

Boolean

true if the match criterion of at least one filter in the table is satisfied by messageBuffer; false if no filter is satisfied.

Implements

GetMatchingFilters(MessageBuffer, ICollection<MessageFilter>)

Exceptions

ArgumentNullException

messageBuffer or results is null.

Remarks

Use this method when more than one filter is expected to match the buffered message and the matching filters are required.

The filters in the table are allowed to inspect the message body.

The matching MessageFilter objects are stored in the results parameter of ICollection<T>. The FilterData can then be recovered from the filter table using these filters as keys with the methods provided by IDictionary<TKey,TValue>.

This method implements GetMatchingFilters.

Applies to

다음을 통해 공유

XPathMessageFilterTable<TFilterData>.GetMatchingFilters Method

Definition

Overloads

Remarks

GetMatchingFilters(SeekableXPathNavigator, ICollection<MessageFilter>)

Parameters

Returns

Exceptions

Remarks

Applies to

GetMatchingFilters(XPathNavigator, ICollection<MessageFilter>)

Parameters

Returns

Exceptions

Remarks

Applies to

GetMatchingFilters(Message, ICollection<MessageFilter>)

Parameters

Returns

Implements

Exceptions

Remarks

Applies to

GetMatchingFilters(MessageBuffer, ICollection<MessageFilter>)

Parameters

Returns

Implements

Exceptions

Remarks

Applies to

추가 리소스