XPathMessageFilterTable<TFilterData>.GetMatchingValues Method
Definition
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 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 and adds the filter data of the matching filters to a collection. |
GetMatchingValues(MessageBuffer, ICollection<TFilterData>) |
Returns a value that indicates whether the match criterion of at least one filter in the table is satisfied by the specified buffered message and adds the filter data of the matching filters to a collection. |
GetMatchingValues(SeekableXPathNavigator, ICollection<TFilterData>) |
Returns a value that indicates whether the match criterion of at least one SeekableXPathNavigator in the table is satisfied by the |
GetMatchingValues(XPathNavigator, ICollection<TFilterData>) |
Returns a value that indicates whether the match criterion of at least one XPathNavigator in the table is satisfied by the |
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 and adds the filter data 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
- results
- ICollection<TFilterData>
The reference parameter that stores the filter data of the matching filters in a generic ICollection<T><FilterData
>.
Returns
true
if match criterion of at least one filter in the table is satisfied by message
; false
if no filter is satisfied.
Implements
Exceptions
message
or results
is null
.
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 filter data is required, and the body of the message is not inspected.
The filter data of the matching MessageFilter objects are stored in the results
parameter of ICollection<T>.
This method implements GetMatchingValues.
Applies to
GetMatchingValues(MessageBuffer, ICollection<TFilterData>)
Returns a value that indicates whether the match criterion of at least one filter in the table is satisfied by the specified buffered message and adds the filter data of the matching filters to a collection.
public:
virtual bool GetMatchingValues(System::ServiceModel::Channels::MessageBuffer ^ messageBuffer, System::Collections::Generic::ICollection<TFilterData> ^ results);
public bool GetMatchingValues (System.ServiceModel.Channels.MessageBuffer messageBuffer, 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 (messageBuffer As MessageBuffer, results As ICollection(Of TFilterData)) As Boolean
Parameters
- messageBuffer
- MessageBuffer
The MessageBuffer to test.
- results
- ICollection<TFilterData>
The reference parameter that stores the filter data of the matching filters in a generic ICollection<T><FilterData
>.
Returns
true
if the match criterion of at least one filter in the table is satisfied by message
; false
if no filter is satisfied.
Implements
Exceptions
messageBuffer
or results
is null
.
Remarks
Use this method when more than one filter is expected to match the buffered message and only the filter data is required.
The filter data of the matching XPathMessageFilter objects are stored in the results
ICollection<T>.
This method implements GetMatchingValues.
Applies to
GetMatchingValues(SeekableXPathNavigator, ICollection<TFilterData>)
Returns a value that indicates whether the match criterion of at least one SeekableXPathNavigator in the table is satisfied by the navigator
and adds the filter data of the matching filters to a collection.
public:
bool GetMatchingValues(System::ServiceModel::Dispatcher::SeekableXPathNavigator ^ navigator, System::Collections::Generic::ICollection<TFilterData> ^ results);
public bool GetMatchingValues (System.ServiceModel.Dispatcher.SeekableXPathNavigator navigator, System.Collections.Generic.ICollection<TFilterData> results);
member this.GetMatchingValues : System.ServiceModel.Dispatcher.SeekableXPathNavigator * System.Collections.Generic.ICollection<'FilterData> -> bool
Public Function GetMatchingValues (navigator As SeekableXPathNavigator, results As ICollection(Of TFilterData)) As Boolean
Parameters
- navigator
- SeekableXPathNavigator
The SeekableXPathNavigator to test.
- results
- ICollection<TFilterData>
The reference parameter that stores the filter data of the matching filters in a generic ICollection<T><FilterData
>.
Returns
true
if the match criterion of at least one filter in the table is satisfied by the navigator
; false
if no filter is satisfied.
Exceptions
navigator
or results
is null
.
Remarks
Use this method when more than one filter is expected to match the query criteria of the XML document derived from the optimized XPath navigator SeekableXPathNavigator and only the filter data is required.
The filter data of the matching XPathMessageFilter objects are stored in the results
parameter of ICollection<T>.
Applies to
GetMatchingValues(XPathNavigator, ICollection<TFilterData>)
Returns a value that indicates whether the match criterion of at least one XPathNavigator in the table is satisfied by the navigator
and adds the filter data of the matching filters to a collection.
public:
bool GetMatchingValues(System::Xml::XPath::XPathNavigator ^ navigator, System::Collections::Generic::ICollection<TFilterData> ^ results);
public bool GetMatchingValues (System.Xml.XPath.XPathNavigator navigator, System.Collections.Generic.ICollection<TFilterData> results);
member this.GetMatchingValues : System.Xml.XPath.XPathNavigator * System.Collections.Generic.ICollection<'FilterData> -> bool
Public Function GetMatchingValues (navigator As XPathNavigator, results As ICollection(Of TFilterData)) As Boolean
Parameters
- navigator
- XPathNavigator
The XPathNavigator to test.
- results
- ICollection<TFilterData>
The reference parameter that stores the filter data of the matching filters in a generic ICollection<T><FilterData
>.
Returns
true
if the match criterion of at least one filter in the table is satisfied by the navigator
; false
if no filter is satisfied.
Exceptions
navigator
or results
is null
.
Remarks
Use this method when more than one filter is expected to match the query criteria of the XML document derived from the optimized XPath navigator SeekableXPathNavigator and only the filter data is required.
The filter data of the matching XPathMessageFilter objects are stored in the results
parameter of ICollection<T>.