XPathMessageFilterTable<TFilterData>.GetMatchingValues 方法

定义

命名空间:

System.ServiceModel.Dispatcher

程序集:

System.ServiceModel.dll

返回一个值，该值指示指定的消息或缓冲消息是否满足表中至少一个筛选器的匹配条件，然后将匹配筛选器的 FilterData 添加到集合。

重载

GetMatchingValues(Message, ICollection<TFilterData>)	返回一个值，该值指示指定的消息是否满足表中至少一个筛选器的匹配条件，然后将匹配筛选器的筛选数据添加到集合。
GetMatchingValues(MessageBuffer, ICollection<TFilterData>)	返回一个值，该值指示指定的缓冲消息是否满足表中至少一个筛选器的匹配条件，然后将匹配筛选器的筛选数据添加到集合。
GetMatchingValues(SeekableXPathNavigator, ICollection<TFilterData>)	返回一个值，该值指示 SeekableXPathNavigator 是否满足表中至少一个 navigator 的匹配条件，然后将匹配筛选器的筛选数据添加到集合。
GetMatchingValues(XPathNavigator, ICollection<TFilterData>)	返回一个值，该值指示 XPathNavigator 是否满足表中至少一个 navigator 的匹配条件，然后将匹配筛选器的筛选数据添加到集合。

注解

当预期有多个筛选器与消息或缓冲消息相匹配，并且只需要 FilterData 时，请使用此方法。

GetMatchingValues(Message, ICollection<TFilterData>)

返回一个值，该值指示指定的消息是否满足表中至少一个筛选器的匹配条件，然后将匹配筛选器的筛选数据添加到集合。

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

参数

message

Message

要测试的 Message。

results

ICollection<TFilterData>

在泛型 ICollection<T><FilterData>中存储匹配筛选器的筛选器数据的引用参数。

返回

Boolean

如果 message 满足表中至少一个筛选器的匹配条件，则为 true；如果不满足任何筛选器，则为 false。

实现

GetMatchingValues(Message, ICollection<TFilterData>)

例外

ArgumentNullException

message 或 results 为 null。

InvalidBodyAccessException

筛选器试图检查消息正文的内容。

注解

当预期会有多个筛选器与消息相匹配，同时只需要筛选数据，且不检查消息的正文时，请使用此方法。

匹配的 MessageFilter 对象的筛选数据存储在 results 的 ICollection<T> 参数中。

此方法实现 GetMatchingValues。

GetMatchingValues(MessageBuffer, ICollection<TFilterData>)

返回一个值，该值指示指定的缓冲消息是否满足表中至少一个筛选器的匹配条件，然后将匹配筛选器的筛选数据添加到集合。

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

参数

messageBuffer

MessageBuffer

要测试的 MessageBuffer。

results

ICollection<TFilterData>

在泛型 ICollection<T><FilterData>中存储匹配筛选器的筛选器数据的引用参数。

返回

Boolean

如果 true 满足表中至少一个筛选器的匹配条件，则为 message；如果不满足任何筛选器，则为 false。

实现

GetMatchingValues(MessageBuffer, ICollection<TFilterData>)

例外

ArgumentNullException

messageBuffer 或 results 为 null。

注解

当预期有多个筛选器与缓冲消息相匹配，并且只需要筛选数据时，请使用此方法。

匹配的 XPathMessageFilter 对象的筛选数据存储在 resultsICollection<T> 中。

此方法实现 GetMatchingValues。

GetMatchingValues(SeekableXPathNavigator, ICollection<TFilterData>)

返回一个值，该值指示 SeekableXPathNavigator 是否满足表中至少一个 navigator 的匹配条件，然后将匹配筛选器的筛选数据添加到集合。

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

参数

navigator

SeekableXPathNavigator

要测试的 SeekableXPathNavigator。

results

ICollection<TFilterData>

在泛型 ICollection<T><FilterData>中存储匹配筛选器的筛选器数据的引用参数。

返回

Boolean

如果 true 满足表中至少一个筛选器的匹配条件，则为 navigator；如果不满足任何筛选器，则为 false。

例外

ArgumentNullException

navigator 或 results 为 null。

注解

当预期会有多个筛选器与派生自优化的 XPath 导航器 SeekableXPathNavigator 的 XML 文档的查询条件相匹配，并且只需要筛选数据时，请使用此方法。

匹配的 XPathMessageFilter 对象的筛选数据存储在 results 的 ICollection<T> 参数中。

GetMatchingValues(XPathNavigator, ICollection<TFilterData>)

返回一个值，该值指示 XPathNavigator 是否满足表中至少一个 navigator 的匹配条件，然后将匹配筛选器的筛选数据添加到集合。

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

参数

navigator

XPathNavigator

要测试的 XPathNavigator。

results

ICollection<TFilterData>

在泛型 ICollection<T><FilterData>中存储匹配筛选器的筛选器数据的引用参数。

返回

Boolean

如果 true 满足表中至少一个筛选器的匹配条件，则为 navigator；如果不满足任何筛选器，则为 false。

例外

ArgumentNullException

navigator 或 results 为 null。

注解

当预期会有多个筛选器与派生自优化的 XPath 导航器 SeekableXPathNavigator 的 XML 文档的查询条件相匹配，并且只需要筛选数据时，请使用此方法。

匹配的 XPathMessageFilter 对象的筛选数据存储在 results 的 ICollection<T> 参数中。