IMessageFilterTable<TFilterData>.GetMatchingFilter IMessageFilterTable<TFilterData>.GetMatchingFilter IMessageFilterTable<TFilterData>.GetMatchingFilter IMessageFilterTable<TFilterData>.GetMatchingFilter Method

Definição

Retorna um filtro da tabela cujos critérios de consulta são atendidos por uma mensagem especificada ou uma mensagem armazenada em buffer.Returns a filter from the table whose query criteria are satisfied by a specified message or buffered message.

Sobrecargas

GetMatchingFilter(Message, MessageFilter) GetMatchingFilter(Message, MessageFilter) GetMatchingFilter(Message, MessageFilter)

Retorna um valor que indica se o critério de correspondência de exatamente um filtro na tabela é atendido pela mensagem especificada e retorna esse filtro em um parâmetro out.Returns a value that indicates whether the match criterion of exactly one filter in the table is satisfied by the specified message, and returns that filter in an out parameter.

GetMatchingFilter(MessageBuffer, MessageFilter) GetMatchingFilter(MessageBuffer, MessageFilter) GetMatchingFilter(MessageBuffer, MessageFilter) GetMatchingFilter(MessageBuffer, MessageFilter)

Retorna um valor que indica se o critério de correspondência de exatamente um filtro na tabela é atendido pela mensagem especificada ou pela mensagem armazenada em buffer e retorna esse filtro em um parâmetro out.Returns a value that indicates whether the match criterion of exactly one filter in the table is satisfied by the specified message or buffered message, and returns that filter in an out parameter.

Comentários

Use esse método quando for esperado que um único filtro corresponda à mensagem e o filtro de correspondência seja necessário.Use this method when a single filter is expected to match the message and the matching filter is required.

Use GetMatchingFilter se o conteúdo do corpo não exigir exame.Use GetMatchingFilter if the body content does not require examination. Use GetMatchingFilter se o conteúdo do corpo da mensagem puder exigir exame.Use GetMatchingFilter if the contents of the message body may require examination.

GetMatchingFilter(Message, MessageFilter) GetMatchingFilter(Message, MessageFilter) GetMatchingFilter(Message, MessageFilter)

Retorna um valor que indica se o critério de correspondência de exatamente um filtro na tabela é atendido pela mensagem especificada e retorna esse filtro em um parâmetro out.Returns a value that indicates whether the match criterion of exactly one filter in the table is satisfied by the specified message, and returns that filter in an out parameter.

public:
 bool GetMatchingFilter(System::ServiceModel::Channels::Message ^ message, [Runtime::InteropServices::Out] System::ServiceModel::Dispatcher::MessageFilter ^ % result);
public bool GetMatchingFilter (System.ServiceModel.Channels.Message message, out System.ServiceModel.Dispatcher.MessageFilter result);
abstract member GetMatchingFilter : System.ServiceModel.Channels.Message * MessageFilter -> bool

Parâmetros

message
Message Message Message Message

O Message a ser testado.The Message to test.

filter
MessageFilter MessageFilter MessageFilter MessageFilter

Parâmetro out que armazena o filtro que é atendido pela message.out parameter that stores the filter that is satisfied by the message. Se não for encontrado nenhum filtro, o parâmetro será definido como seu valor padrão.If no filter was found, the parameter is set to its default value.

Retornos

true se o critério de correspondência de pelo menos um filtro na tabela for atendido por message; false se nenhum filtro for atendido.true if the match criterion of at least one filter in the table is satisfied by message; false if no filter is satisfied.

Comentários

Use esse método quando for esperado que um único filtro corresponda à mensagem e o filtro de correspondência seja necessário.Use this method when a single filter is expected to match the message and the matching filter is required.

Se o corpo da mensagem precisar ser inspecionado por um filtro na tabela de filtros, use a GetMatchingFilter versão do método.If the body of the message must be inspected by a filter in the filter table, use the GetMatchingFilter version of the method.

Notas aos Implementadores

Se mais de um filtro corresponder à mensagem, um MultipleFilterMatchesException deverá ser lançado.If more than one filter matches the message, a MultipleFilterMatchesException must be thrown.

Essa versão leva um Message e deve lançar um InvalidBodyAccessException se tentar examinar o corpo da mensagem.This version takes a Message and must throw an InvalidBodyAccessException if it tries to examine the message body.

GetMatchingFilter(MessageBuffer, MessageFilter) GetMatchingFilter(MessageBuffer, MessageFilter) GetMatchingFilter(MessageBuffer, MessageFilter) GetMatchingFilter(MessageBuffer, MessageFilter)

Retorna um valor que indica se o critério de correspondência de exatamente um filtro na tabela é atendido pela mensagem especificada ou pela mensagem armazenada em buffer e retorna esse filtro em um parâmetro out.Returns a value that indicates whether the match criterion of exactly one filter in the table is satisfied by the specified message or buffered message, and returns that filter in an out parameter.

public:
 bool GetMatchingFilter(System::ServiceModel::Channels::MessageBuffer ^ buffer, [Runtime::InteropServices::Out] System::ServiceModel::Dispatcher::MessageFilter ^ % result);
public bool GetMatchingFilter (System.ServiceModel.Channels.MessageBuffer buffer, out System.ServiceModel.Dispatcher.MessageFilter result);
abstract member GetMatchingFilter : System.ServiceModel.Channels.MessageBuffer * MessageFilter -> bool
Public Function GetMatchingFilter (buffer As MessageBuffer, ByRef result As MessageFilter) As Boolean

Parâmetros

filter
MessageFilter MessageFilter MessageFilter MessageFilter

Parâmetro out que armazena o filtro que é atendido pela message.out parameter that stores the filter that is satisfied by the message. Se não for encontrado nenhum filtro, o parâmetro será definido como seu valor padrão.If no filter was found, the parameter is set to its default value.

Retornos

true se o critério de correspondência de pelo menos um filtro na tabela for atendido por messageBuffer; false se nenhum filtro for atendido.true if the match criterion of at least one filter in the table is satisfied by messageBuffer; false if no filter is satisfied.

Comentários

Use esse método quando for esperado que um único filtro corresponda à mensagem armazenada em buffer, o filtro de correspondência deverá ser retornado e o corpo da mensagem poderá ter que ser inspecionado.Use this method when a single filter is expected to match the buffered message, the matching filter must be returned, and the body of the message may have to be inspected.

Aplica-se a