IMessageFilterTable<TFilterData>.GetMatchingFilter Método

Definição

Devolve um filtro da tabela cujos critérios de consulta são satisfeitos por uma mensagem ou mensagem em buffer especificada.

Sobrecargas

Name Description
GetMatchingFilter(Message, MessageFilter)

Devolve um valor que indica se o critério de correspondência de exatamente um filtro na tabela é satisfeito pela mensagem especificada, e devolve esse filtro num out parâmetro.

GetMatchingFilter(MessageBuffer, MessageFilter)

Devolve um valor que indica se o critério de correspondência de exatamente um filtro na tabela é satisfeito pela mensagem especificada ou mensagem em buffer, e devolve esse filtro num out parâmetro.

Observações

Use este método quando se espera que um único filtro corresponda à mensagem e o filtro correspondente for necessário.

Use GetMatchingFilter se o conteúdo do corpo não exigir exame. Use GetMatchingFilter se o conteúdo do corpo da mensagem puder exigir análise.

GetMatchingFilter(Message, MessageFilter)

Origem:
IMessageFilterTable.cs
Origem:
IMessageFilterTable.cs
Origem:
IMessageFilterTable.cs

Devolve um valor que indica se o critério de correspondência de exatamente um filtro na tabela é satisfeito pela mensagem especificada, e devolve esse filtro num out parâmetro.

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

Parâmetros

message
Message

O Message teste.

filter
MessageFilter

out que armazena o filtro que é satisfeito pelo message. Se não for encontrado filtro, o parâmetro é definido para o seu valor predefinido.

Devoluções

true se o critério de correspondência de pelo menos um filtro na tabela for satisfeito por message; false se nenhum filtro for satisfeito.

Observações

Use este método quando se espera que um único filtro corresponda à mensagem e o filtro correspondente for necessário.

Se o corpo da mensagem tiver de ser inspecionado por um filtro na tabela de filtros, use a GetMatchingFilter versão do método.

Notas para Implementadores

Se mais do que um filtro corresponder à mensagem, tem de ser lançado um.MultipleFilterMatchesException

Esta versão toma um Message e deve lançar um InvalidBodyAccessException se tentar examinar o corpo da mensagem.

Aplica-se a

GetMatchingFilter(MessageBuffer, MessageFilter)

Origem:
IMessageFilterTable.cs
Origem:
IMessageFilterTable.cs
Origem:
IMessageFilterTable.cs

Devolve um valor que indica se o critério de correspondência de exatamente um filtro na tabela é satisfeito pela mensagem especificada ou mensagem em buffer, e devolve esse filtro num out parâmetro.

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

Parâmetros

messageBuffer
MessageBuffer

O MessageBuffer teste.

filter
MessageFilter

out que armazena o filtro que é satisfeito pelo message. Se não for encontrado filtro, o parâmetro é definido para o seu valor predefinido.

Devoluções

true se o critério de correspondência de pelo menos um filtro na tabela for satisfeito por messageBuffer; false se nenhum filtro for satisfeito.

Observações

Use este método quando se espera que um único filtro corresponda à mensagem em buffer, o filtro correspondente deve ser devolvido e o corpo da mensagem pode ter de ser inspecionado.

Aplica-se a