MessageFilterTable<TFilterData>.GetMatchingFilter 方法

定义

命名空间:

System.ServiceModel.Dispatcher

程序集:

System.ServiceModel.dll

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

重载

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

注解

测试某一消息是否符合筛选器表中任一筛选器的要求。

GetMatchingFilter(MessageBuffer, MessageFilter)

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

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

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

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

public bool GetMatchingFilter (System.ServiceModel.Channels.MessageBuffer buffer, out System.ServiceModel.Dispatcher.MessageFilter result);

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

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

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

Public Function GetMatchingFilter (buffer As MessageBuffer, ByRef result As MessageFilter) As Boolean

参数

buffer

MessageBuffer

要测试的 MessageBuffer。

filterresult

MessageFilter

out 参数，该参数存储 buffer 符合的筛选器。

返回

Boolean

如果消息正好满足表中一个筛选器的匹配条件，则为 true；如果不满足任何筛选器，则为 false。

实现

GetMatchingFilter(MessageBuffer, MessageFilter)

例外

MultipleFilterMatchesException

多个 ActionMessageFilter 与 messageBuffer 相匹配。

注解

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

此方法实现 GetMatchingFilter。

GetMatchingFilter(Message, MessageFilter)

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

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

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

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

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

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

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

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

参数

message

Message

要测试的 Message。

filterresult

MessageFilter

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

返回

Boolean

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

实现

GetMatchingFilter(Message, MessageFilter)

例外

MultipleFilterMatchesException

多个 ActionMessageFilter 与 messageBuffer 相匹配。

注解

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

如果必须由筛选器表中的筛选器来检查消息的正文，请使用该方法的 GetMatchingFilter 版本。