XPathMessageFilterTable<TFilterData>.GetMatchingFilters 方法

定义

命名空间:

System.ServiceModel.Dispatcher

程序集:

System.ServiceModel.dll

返回一个值，该值指示指定的 XML 文档是否满足表中筛选器的匹配条件，然后将匹配筛选器添加到集合。

重载

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

注解

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

GetMatchingFilters(SeekableXPathNavigator, ICollection<MessageFilter>)

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

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

参数

navigator

SeekableXPathNavigator

要测试的 SeekableXPathNavigator。

results

ICollection<MessageFilter>

存储 ICollection<T><Filter> 中匹配的 MessageFilter 对象的引用参数。

返回

Boolean

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

例外

ArgumentNullException

navigator 或 results 为 null。

注解

当预期会有多个筛选器与导航器匹配，并且需要匹配筛选器时，请使用此方法。

如果预期只有一个筛选器与消息相匹配，请使用 GetMatchingFilter 方法。

GetMatchingFilters(XPathNavigator, ICollection<MessageFilter>)

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

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

参数

navigator

XPathNavigator

要测试的 XPathNavigator。

results

ICollection<MessageFilter>

存储 ICollection<T><Filter> 中匹配的 MessageFilter 对象的引用参数。

返回

Boolean

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

例外

ArgumentNullException

navigator 或 results 为 null。

注解

当预期会有多个筛选器与 XPathNavigator 指定的消息相匹配，并且需要匹配筛选器时，请使用此方法。

如果预期只有一个筛选器与消息相匹配，请使用 GetMatchingFilter 方法。

GetMatchingFilters(Message, ICollection<MessageFilter>)

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

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

参数

message

Message

要测试的 Message。

results

ICollection<MessageFilter>

存储 ICollection<T><Filter> 中匹配的 MessageFilter 对象的引用参数。

返回

Boolean

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

实现

GetMatchingFilters(Message, ICollection<MessageFilter>)

例外

ArgumentNullException

message 或 results 为 null。

InvalidBodyAccessException

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

注解

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

不允许表中的筛选器检查消息正文。

匹配的 XPathMessageFilter 对象存储在 results 的 ICollection<T> 参数中。 然后，可以使用这些筛选器作为键，通过 FilterData 提供的方法从筛选器表恢复 IDictionary<TKey,TValue>。

此方法实现 GetMatchingFilters。

GetMatchingFilters(MessageBuffer, ICollection<MessageFilter>)

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

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

参数

messageBuffer

MessageBuffer

要测试的 MessageBuffer。

results

ICollection<MessageFilter>

存储 ICollection<T><Filter> 中匹配的 MessageFilter 对象的引用参数。

返回

Boolean

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

实现

GetMatchingFilters(MessageBuffer, ICollection<MessageFilter>)

例外

ArgumentNullException

messageBuffer 或 results 为 null。

注解

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

允许表中的筛选器检查消息正文。

匹配的 MessageFilter 对象存储在 results 的 ICollection<T> 参数中。 然后，可以使用这些筛选器作为键，通过 FilterData 提供的方法从筛选器表恢复 IDictionary<TKey,TValue>。

此方法实现 GetMatchingFilters。