IMessageFilterTable<TFilterData>.GetMatchingFilter 方法

定義

命名空間:

System.ServiceModel.Dispatcher

組件:

System.ServiceModel.dll

從資料表傳回篩選條件，有某個指定訊息或緩衝訊息符合此篩選條件的查詢準則。

多載

GetMatchingFilter(Message, MessageFilter)	傳回值，這個值會表示指定的訊息是否剛好只符合資料表中單一篩選條件的比對準則，並且傳回 out 參數中的該篩選條件。
GetMatchingFilter(MessageBuffer, MessageFilter)	傳回值，這個值會指出指定的訊息或是緩衝的訊息是否只符合資料表中單一篩選條件的比對準則，並且傳回在 out 參數中的篩選條件。

備註

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

如果不需要檢查本文內容，便可使用 GetMatchingFilter。 如果可能需要檢查訊息本文的內容，便可使用 GetMatchingFilter。

GetMatchingFilter(Message, MessageFilter)

傳回值，這個值會表示指定的訊息是否剛好只符合資料表中單一篩選條件的比對準則，並且傳回 out 參數中的該篩選條件。

public:
 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

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

參數

message

Message

要測試的 Message。

filter

MessageFilter

out 參數，其中儲存 message 所符合的篩選條件。 如果找不到任何篩選條件，此參數會設定為預設值。

傳回

Boolean

如果 true 符合資料表中至少一個篩選條件的比對準則，則為 message，如果沒有符合任何篩選條件，則為 false。

備註

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

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

給實施者的注意事項

如果有一個以上的篩選條件與訊息相符，這時一定會擲回 MultipleFilterMatchesException。

這個版本會接受 Message，而如果它嘗試檢查訊息本文，就一定會擲回 InvalidBodyAccessException。

GetMatchingFilter(MessageBuffer, MessageFilter)

傳回值，這個值會指出指定的訊息或是緩衝的訊息是否只符合資料表中單一篩選條件的比對準則，並且傳回在 out 參數中的篩選條件。

public:
 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

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

參數

messageBuffer

MessageBuffer

要測試的 MessageBuffer。

filter

MessageFilter

out 參數，其中儲存 message 所符合的篩選條件。 如果找不到任何篩選條件，此參數會設定為預設值。

傳回

Boolean

如果 true 符合資料表中至少一個篩選條件的比對準則，則為 messageBuffer，如果沒有符合任何篩選條件，則為 false。

備註

當預期有單一篩選條件與緩衝的訊息相符，必須傳回相符的篩選條件，以及訊息本文可能必須進行檢查時，便可使用這個方法。