IMessageFilterTable<TFilterData>.GetMatchingFilter Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Retorna um filtro da tabela cujos critérios de consulta são atendidos por uma mensagem especificada ou mensagem em buffer.
Sobrecargas
| Nome | Description |
|---|---|
| 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 |
| 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 mensagem em buffer e retorna esse filtro em um |
Comentários
Use esse método quando um único filtro for esperado para corresponder à 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 pode exigir exame.
GetMatchingFilter(Message, MessageFilter)
- Origem:
- IMessageFilterTable.cs
- Origem:
- IMessageFilterTable.cs
- Origem:
- IMessageFilterTable.cs
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 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 -> boolPublic Function GetMatchingFilter (message As Message, ByRef filter As MessageFilter) As BooleanParâmetros
- filter
- MessageFilter
out que armazena o filtro que é satisfeito pelo message. Se nenhum filtro foi encontrado, o parâmetro será definido como seu valor padrão.
Retornos
truese o critério de correspondência de pelo menos um filtro na tabela for atendido; messagefalse se nenhum filtro for atendido.
Comentários
Use esse método quando um único filtro for esperado para corresponder à mensagem e o filtro correspondente for necessário.
Se o corpo da mensagem precisar ser inspecionado por um filtro na tabela de filtro, use a GetMatchingFilter versão do método.
Notas aos Implementadores
Se mais de um filtro corresponder à mensagem, será necessário gerar um MultipleFilterMatchesException .
Essa versão usa um Message e deve gerar um InvalidBodyAccessException se tentar examinar o corpo da mensagem.
Aplica-se a
GetMatchingFilter(MessageBuffer, MessageFilter)
- Origem:
- IMessageFilterTable.cs
- Origem:
- IMessageFilterTable.cs
- Origem:
- IMessageFilterTable.cs
Retorna um valor que indica se o critério de correspondência de exatamente um filtro na tabela é atendido pela mensagem especificada ou mensagem em buffer e retorna esse filtro em um 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 -> boolPublic Function GetMatchingFilter (messageBuffer As MessageBuffer, ByRef filter As MessageFilter) As BooleanParâmetros
- messageBuffer
- MessageBuffer
O MessageBuffer teste a ser testado.
- filter
- MessageFilter
out que armazena o filtro que é satisfeito pelo message. Se nenhum filtro foi encontrado, o parâmetro será definido como seu valor padrão.
Retornos
truese o critério de correspondência de pelo menos um filtro na tabela for atendido; messageBufferfalse se nenhum filtro for atendido.
Comentários
Use esse método quando se espera que um único filtro corresponda à mensagem em buffer, o filtro correspondente deve ser retornado e o corpo da mensagem pode precisar ser inspecionado.
