XPathMessageFilterTable<TFilterData>.GetMatchingFilter 方法

定义

命名空间:

System.ServiceModel.Dispatcher

程序集:

System.ServiceModel.dll

返回一个值，该值指示指定的消息或缓冲消息是否正好满足表中的一个筛选器的匹配条件，然后在 out 参数中返回该筛选器。

重载

GetMatchingFilter(Message, MessageFilter)	返回一个值，该值指示指定的消息是否正好满足表中的一个筛选器的匹配标准，然后在 out 参数中返回该筛选器。
GetMatchingFilter(MessageBuffer, MessageFilter)	返回一个值，该值指示指定的消息或缓冲消息是否正好满足表中的一个筛选器的匹配条件，然后在 out 参数中返回该筛选器。
GetMatchingFilter(SeekableXPathNavigator, MessageFilter)	返回一个值，该值指示指定的消息或缓冲消息是否正好满足表中的一个 SeekableXPathNavigator 的匹配条件，然后在 out 参数中返回该筛选器。
GetMatchingFilter(XPathNavigator, MessageFilter)	返回一个值，该值指示指定的消息或缓冲消息是否正好满足表中的一个 XPathNavigator 的匹配条件，然后在 out 参数中返回该筛选器。

注解

测试某一消息是否正好符合筛选器表中其中一个筛选器的要求。

GetMatchingFilter(Message, MessageFilter)

返回一个值，该值指示指定的消息是否正好满足表中的一个筛选器的匹配标准，然后在 out 参数中返回该筛选器。

public:
 virtual bool GetMatchingFilter(System::ServiceModel::Channels::Message ^ message, [Runtime::InteropServices::Out] System::ServiceModel::Dispatcher::MessageFilter ^ % filter);

public bool GetMatchingFilter (System.ServiceModel.Channels.Message message, out System.ServiceModel.Dispatcher.MessageFilter filter);

abstract member GetMatchingFilter : System.ServiceModel.Channels.Message * MessageFilter -> bool
override this.GetMatchingFilter : System.ServiceModel.Channels.Message * MessageFilter -> bool

Public Function GetMatchingFilter (message As Message, ByRef filter As MessageFilter) As Boolean

参数

message

Message

要测试的 Message。

filter

MessageFilter

out 参数，该参数存储 message 符合的筛选器。 如果找不到筛选器，该参数将设置为默认值。

返回

Boolean

消息满足其查询条件的 MessageFilter；如果未找到任何匹配的筛选器，则返回 null。

实现

GetMatchingFilter(Message, MessageFilter)

例外

ArgumentNullException

message 为 null。

MultipleFilterMatchesException

多个筛选器与 message 相匹配。

InvalidBodyAccessException

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

注解

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

此方法对优先级最高的筛选器存储桶中的单个筛选器匹配进行测试。 不允许表中的筛选器检查消息正文。

如果预期会有多个筛选器与消息相匹配，请使用 GetMatchingFilters。

此方法实现 GetMatchingFilter。

GetMatchingFilter(MessageBuffer, MessageFilter)

返回一个值，该值指示指定的消息或缓冲消息是否正好满足表中的一个筛选器的匹配条件，然后在 out 参数中返回该筛选器。

public:
 virtual bool GetMatchingFilter(System::ServiceModel::Channels::MessageBuffer ^ messageBuffer, [Runtime::InteropServices::Out] System::ServiceModel::Dispatcher::MessageFilter ^ % filter);

public bool GetMatchingFilter (System.ServiceModel.Channels.MessageBuffer messageBuffer, out System.ServiceModel.Dispatcher.MessageFilter filter);

abstract member GetMatchingFilter : System.ServiceModel.Channels.MessageBuffer * MessageFilter -> bool
override this.GetMatchingFilter : System.ServiceModel.Channels.MessageBuffer * MessageFilter -> bool

Public Function GetMatchingFilter (messageBuffer As MessageBuffer, ByRef filter As MessageFilter) As Boolean

参数

messageBuffer

MessageBuffer

要测试的 MessageBuffer。

filter

MessageFilter

out 参数，该参数存储 message 符合的筛选器。 如果找不到筛选器，该参数将设置为默认值。

返回

Boolean

缓冲消息满足其查询条件的 MessageFilter；如果未找到任何匹配的筛选器，则返回 null。

实现

GetMatchingFilter(MessageBuffer, MessageFilter)

例外

ArgumentNullException

messageBuffer 为 null。

MultipleFilterMatchesException

多个筛选器与 messageBuffer 相匹配。

注解

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

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

如果预期会有多个筛选器与消息相匹配，请使用 GetMatchingFilters。

此方法实现 GetMatchingFilter。

GetMatchingFilter(SeekableXPathNavigator, MessageFilter)

返回一个值，该值指示指定的消息或缓冲消息是否正好满足表中的一个 SeekableXPathNavigator 的匹配条件，然后在 out 参数中返回该筛选器。

public:
 bool GetMatchingFilter(System::ServiceModel::Dispatcher::SeekableXPathNavigator ^ navigator, [Runtime::InteropServices::Out] System::ServiceModel::Dispatcher::MessageFilter ^ % filter);

public bool GetMatchingFilter (System.ServiceModel.Dispatcher.SeekableXPathNavigator navigator, out System.ServiceModel.Dispatcher.MessageFilter filter);

member this.GetMatchingFilter : System.ServiceModel.Dispatcher.SeekableXPathNavigator * MessageFilter -> bool

Public Function GetMatchingFilter (navigator As SeekableXPathNavigator, ByRef filter As MessageFilter) As Boolean

参数

navigator

SeekableXPathNavigator

要测试的 SeekableXPathNavigator。

filter

MessageFilter

out 参数，该参数存储 message 符合的筛选器。 如果找不到筛选器，该参数将设置为默认值。

返回

Boolean

缓冲消息满足其查询条件的 MessageFilter；如果未找到任何匹配的筛选器，则返回 null。

例外

ArgumentNullException

navigator 为 null。

MultipleFilterMatchesException

多个筛选器与 navigator 相匹配。

注解

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

如果预期会有多个筛选器与消息相匹配，请使用 GetMatchingFilters。

GetMatchingFilter(XPathNavigator, MessageFilter)

返回一个值，该值指示指定的消息或缓冲消息是否正好满足表中的一个 XPathNavigator 的匹配条件，然后在 out 参数中返回该筛选器。

public:
 bool GetMatchingFilter(System::Xml::XPath::XPathNavigator ^ navigator, [Runtime::InteropServices::Out] System::ServiceModel::Dispatcher::MessageFilter ^ % filter);

public bool GetMatchingFilter (System.Xml.XPath.XPathNavigator navigator, out System.ServiceModel.Dispatcher.MessageFilter filter);

member this.GetMatchingFilter : System.Xml.XPath.XPathNavigator * MessageFilter -> bool

Public Function GetMatchingFilter (navigator As XPathNavigator, ByRef filter As MessageFilter) As Boolean

参数

navigator

XPathNavigator

要测试的 XPathNavigator。

filter

MessageFilter

out 参数，该参数存储 navigator 符合的筛选器。 如果找不到筛选器，该参数将设置为默认值。

返回

Boolean

缓冲消息满足其查询条件的 MessageFilter；如果未找到任何匹配的筛选器，则返回 null。

例外

ArgumentNullException

navigator 为 null。

MultipleFilterMatchesException

多个筛选器与 navigator 相匹配。

注解

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

如果预期会有多个筛选器与消息相匹配，请使用 GetMatchingFilters。