IMessageFilterTable<TFilterData>.GetMatchingValue Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Devolve um valor que indica se o critério de correspondência de um filtro na tabela é satisfeito pela mensagem especificada ou pela mensagem em buffer, e devolve os dados do filtro correspondentes.
Sobrecargas
| Name | Description |
|---|---|
| GetMatchingValue(Message, TFilterData) |
Devolve um valor que indica se o critério de correspondência de exatamente um filtro na tabela é satisfeito pela mensagem especificada, e adiciona os dados do filtro correspondente a uma coleção. |
| GetMatchingValue(MessageBuffer, TFilterData) |
Devolve um valor que indica se o critério de correspondência de exatamente um filtro na tabela é satisfeito pela mensagem em buffer especificada, e adiciona os dados do filtro correspondente a uma coleção. |
Observações
Use um destes métodos quando, no máximo, se espera que um filtro corresponda à mensagem e apenas os dados do filtro correspondente devem ser recuperados. Estes métodos retornam um booleano que indica se foi encontrado um filtro correspondente e definem o data parâmetro de referência para os dados do filtro correspondente.
Use GetMatchingFilter se o corpo da mensagem não for inspecionado por nenhum dos filtros na tabela de filtros.
Se o corpo da mensagem puder ser inspecionado por um filtro na tabela de filtros, armazene a mensagem em buffer e passe-a para a GetMatchingFilter versão do método.
GetMatchingValue(Message, TFilterData)
- 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 adiciona os dados do filtro correspondente a uma coleção.
public:
bool GetMatchingValue(System::ServiceModel::Channels::Message ^ message, [Runtime::InteropServices::Out] TFilterData % value);public bool GetMatchingValue(System.ServiceModel.Channels.Message message, out TFilterData value);abstract member GetMatchingValue : System.ServiceModel.Channels.Message * 'FilterData -> boolPublic Function GetMatchingValue (message As Message, ByRef value As TFilterData) As BooleanParâmetros
- value
- TFilterData
out parâmetro que armazena o FilterData que corresponde ao message.
Devoluções
true se o critério de correspondência de exatamente um filtro na tabela for satisfeito pela mensagem; false se nenhum filtro for satisfeito.
Observações
Use este método quando se espera que um único filtro corresponda à mensagem e apenas os dados do filtro correspondente devem ser recuperados.
Este método espera, no máximo, um único filtro correspondente. Se mais do que um filtro corresponder, tem de ser lançado um MultipleFilterMatchesException a.
Se o corpo da mensagem tiver de ser inspecionado por um filtro na tabela de filtros, armazene a mensagem em buffer e CreateBufferedCopy transmita-a para a GetMatchingValue versão do método.
Notas para Implementadores
Se mais do que um filtro corresponder à mensagem, tem de ser lançado um.MultipleFilterMatchesException
Esta sobrecarga requer um Message e deve lançar um InvalidBodyAccessException se tentar examinar o corpo da mensagem.
Aplica-se a
GetMatchingValue(MessageBuffer, TFilterData)
- 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 em buffer especificada, e adiciona os dados do filtro correspondente a uma coleção.
public:
bool GetMatchingValue(System::ServiceModel::Channels::MessageBuffer ^ messageBuffer, [Runtime::InteropServices::Out] TFilterData % value);public bool GetMatchingValue(System.ServiceModel.Channels.MessageBuffer messageBuffer, out TFilterData value);abstract member GetMatchingValue : System.ServiceModel.Channels.MessageBuffer * 'FilterData -> boolPublic Function GetMatchingValue (messageBuffer As MessageBuffer, ByRef value As TFilterData) As BooleanParâmetros
- messageBuffer
- MessageBuffer
O MessageBuffer teste.
- value
- TFilterData
out parâmetro que armazena o FilterData que corresponde ao messageBuffer.
Devoluções
true se o critério de correspondência de exatamente um filtro na tabela for satisfeito pela mensagem; false se nenhum filtro for satisfeito.
Observações
Use este método quando se espera que um único filtro corresponda à mensagem em buffer, apenas os dados do filtro correspondente devem ser recuperados, e o corpo da mensagem pode ter de ser inspecionado.
Notas para Implementadores
Se mais do que um filtro corresponder à mensagem, tem de ser lançado um.MultipleFilterMatchesException
