EndpointAddressMessageFilter.Match 方法

定義

命名空間:

System.ServiceModel.Dispatcher

組件:

System.ServiceModel.dll

測試訊息或緩衝訊息是否符合端點篩選器的準則。

多載

Match(Message)	測試訊息是否符合指定的端點位址。
Match(MessageBuffer)	測試緩衝的訊息是否符合指定的端點位址。

備註

兩個 Match 方法多載之間的差異在於，接受 MessageBuffer 參數的多載可以在測試是否相符時檢查訊息的本文，而另一個接受 Message 參數的多載則不可以。

Match 並不會測試訊息本文的內容，所以這兩個方法是對等的。

Match(Message)

測試訊息是否符合指定的端點位址。

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

如果 true 物件符合篩選條件中指定的端點位址，則為 Message，否則為 false。

例外狀況

ArgumentNullException

message 為 null。

備註

因為這兩個方法多載只會檢查訊息標頭，所以是對等的。

Match(MessageBuffer)

測試緩衝的訊息是否符合指定的端點位址。

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

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

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

Public Overrides Function Match (messageBuffer As MessageBuffer) As Boolean

參數

messageBuffer

MessageBuffer

要測試的 MessageBuffer 物件。

傳回

Boolean

如果 true 物件符合端點位址，則為 MessageBuffer，否則為 false。

例外狀況

ArgumentNullException

messageBuffer 為 null。

備註

因為這兩個方法多載只會檢查訊息標頭，所以是對等的。 因為這個方法會將 messageBuffer 轉換為訊息，所以使用這個多載的唯一時機是當您已經有可用的 messageBuffer 而沒有訊息時。