ActionMessageFilter.Match 方法

定義

命名空間:

System.ServiceModel.Dispatcher

組件:

System.ServiceModel.dll

測試訊息或緩衝訊息是否符合其中一個已針對篩選條件所設定的動作。

多載

Match(Message)	測試訊息的動作是否符合這個 ActionMessageFilter 所指定的其中一個動作。
Match(MessageBuffer)	測試緩衝訊息的動作標頭是否符合這個 ActionMessageFilter 所指定的其中一個動作。

備註

這兩個多載之間的差異，在於一個多載會接受 Message 參數但是無法檢查訊息本文，另外一個多載會接受 MessageBuffer 參數並且可以檢查訊息的任何部分。 因為動作篩選條件並不會檢查本文，所以這些方法是對等的。

如果您必須針對多個 ActionMessageFilter 物件來檢查訊息，請將篩選條件放入 IMessageFilterTable<TFilterData>，接著使用資料表所提供的比對功能。

Match(Message)

測試訊息的動作是否符合這個 ActionMessageFilter 所指定的其中一個動作。

public:
 override bool Match(System::ServiceModel::Channels::Message ^ message);

public override bool Match (System.ServiceModel.Channels.Message message);

override this.Match : System.ServiceModel.Channels.Message -> bool

Public Overrides Function Match (message As Message) As Boolean

參數

message

Message

要測試的 Message。

傳回

Boolean

如果 Message 動作標頭符合其中一個指定的動作，則為 true，否則為 false。

例外狀況

ArgumentNullException

message 為 null。

備註

當訊息必須針對單一篩選條件中的動作進行測試，而且可以使用 Match 時，便可使用這個 Message 多載。

Match(MessageBuffer)

測試緩衝訊息的動作標頭是否符合這個 ActionMessageFilter 所指定的其中一個動作。

public:
 override bool Match(System::ServiceModel::Channels::MessageBuffer ^ messageBuffer);

public:
 override bool Match(System::ServiceModel::Channels::MessageBuffer ^ buffer);

public override bool Match (System.ServiceModel.Channels.MessageBuffer messageBuffer);

public override bool Match (System.ServiceModel.Channels.MessageBuffer buffer);

override this.Match : System.ServiceModel.Channels.MessageBuffer -> bool

override this.Match : System.ServiceModel.Channels.MessageBuffer -> bool

Public Overrides Function Match (messageBuffer As MessageBuffer) As Boolean

Public Overrides Function Match (buffer As MessageBuffer) As Boolean

參數

messageBufferbuffer

MessageBuffer

要測試的 MessageBuffer。

傳回

Boolean

如果 MessageBuffer 動作標頭符合其中一個指定的動作，則為 true，否則為 false。

例外狀況

ArgumentNullException

messageBuffer 為 null。

備註

當訊息必須針對單一篩選條件中的動作進行測試，而且可以使用 Match 時，便可使用這個 MessageBuffer 方法多載。