EndpointAddressMessageFilter.Match Método

Definição

Namespace:

System.ServiceModel.Dispatcher

Assembly:

System.ServiceModel.dll

Testa se uma mensagem ou mensagem em buffer satisfaz os critérios do filtro do ponto de extremidade.

Sobrecargas

Match(Message)	Testa se uma mensagem satisfaz o endereço do ponto de extremidade especificado.
Match(MessageBuffer)	Testa se uma mensagem em buffer satisfaz o endereço do ponto de extremidade especificado.

Comentários

A diferença entre as duas sobrecargas do Match método é que a que usa o MessageBuffer parâmetro tem permissão para examinar o corpo de uma mensagem durante o teste de uma correspondência, enquanto aquela que usa o Message parâmetro não é.

Match não testa o conteúdo do corpo de uma mensagem, portanto, esses dois métodos são equivalentes.

Match(Message)

Testa se uma mensagem satisfaz o endereço do ponto de extremidade especificado.

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

Parâmetros

message

Message

O objeto Message a ser testado.

Retornos

Boolean

true se o objeto false satisfizer o endereço do ponto de extremidade especificado no filtro; caso contrário, Message.

Exceções

ArgumentNullException

message é null.

Comentários

As duas sobrecargas desse método são equivalentes porque ambos examinam apenas os cabeçalhos de mensagem.

Match(MessageBuffer)

Testa se uma mensagem em buffer satisfaz o endereço do ponto de extremidade especificado.

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

Parâmetros

messageBuffer

MessageBuffer

O objeto MessageBuffer a ser testado.

Retornos

Boolean

true se o objeto false satisfizer o endereço do ponto de extremidade; caso contrário, MessageBuffer.

Exceções

ArgumentNullException

messageBuffer é null.

Comentários

As duas sobrecargas desse método são equivalentes porque ambos examinam apenas os cabeçalhos de mensagem. O único motivo para usar essa sobrecarga é se você já tiver uma messageBuffer disponível e não uma mensagem, porque esse método converte o messageBuffer em uma mensagem.