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 bool GetMatchingFilter (System.ServiceModel.Channels.MessageBuffer buffer, 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 (buffer As MessageBuffer, ByRef filter As MessageFilter) As Boolean

參數

buffer

MessageBuffer

要測試的 MessageBuffer。

filter

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 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 的比對準則，則為 true，如果沒有符合任何篩選條件，則為 false。

實作

GetMatchingFilter(Message, MessageFilter)

例外狀況

MultipleFilterMatchesException

有一個以上的 ActionMessageFilter 符合 messageBuffer。

備註

當預期有單一篩選條件要比對該訊息，而且需要相符的篩選條件時，便可使用這個方法。

如果必須使用篩選資料表中的篩選條件檢查訊息本文，請使用 GetMatchingFilter 版本的方法。