IMessageFilterTable<TFilterData>.GetMatchingValue IMessageFilterTable<TFilterData>.GetMatchingValue IMessageFilterTable<TFilterData>.GetMatchingValue IMessageFilterTable<TFilterData>.GetMatchingValue Method

Definição

Retorna um valor que indica se o critério de correspondência de um filtro na tabela é atendido pela mensagem especificada ou pela mensagem armazenada em buffer e retorna os dados do filtro correspondente.Returns a value that indicates whether the match criterion of a filter in the table is satisfied by the specified message or buffered message, and returns the filter data for the filter that matched.

Sobrecargas

GetMatchingValue(Message, TFilterData) GetMatchingValue(Message, TFilterData) GetMatchingValue(Message, TFilterData)

Retorna um valor que indica se o critério de correspondência de exatamente um filtro na tabela é atendido pela mensagem especificada e adiciona os dados do filtro correspondente a uma coleção.Returns a value that indicates whether the match criterion of exactly one filter in the table is satisfied by the specified message, and adds the matching filter data to a collection.

GetMatchingValue(MessageBuffer, TFilterData) GetMatchingValue(MessageBuffer, TFilterData) GetMatchingValue(MessageBuffer, TFilterData) GetMatchingValue(MessageBuffer, TFilterData)

Retorna um valor que indica se o critério de correspondência de exatamente um filtro na tabela é atendido pela mensagem em buffer especificada e adiciona os dados do filtro correspondente a uma coleção.Returns a value that indicates whether the match criterion of exactly one filter in the table is satisfied by the specified buffered message, and adds the matching filter data to a collection.

Comentários

Use um desses métodos quando, no máximo, um filtro é esperado para corresponder à mensagem e somente os dados de filtro do filtro de correspondência devem ser recuperados.Use one of these methods when, at most, one filter is expected to match the message and only the filter data from the matching filter must be recovered. Esses métodos retornam um booliano que indica se um filtro correspondente foi encontrado e data define o parâmetro de referência para os dados de filtro correspondentes.These methods return a boolean that indicates whether a matching filter was found and set the data reference parameter to the matching filter data.

Use GetMatchingFilter se o corpo da mensagem não for inspecionado por nenhum dos filtros na tabela de filtros.Use GetMatchingFilter if the body of the message is not inspected by any of the filters in the filter table.

Se o corpo da mensagem puder ser inspecionado por um filtro na tabela de filtros, buffere a mensagem e passe-a para GetMatchingFilter a versão do método.If the body of the message may be inspected by a filter in the filter table, buffer the message and pass it to the GetMatchingFilter version of the method.

GetMatchingValue(Message, TFilterData) GetMatchingValue(Message, TFilterData) GetMatchingValue(Message, TFilterData)

Retorna um valor que indica se o critério de correspondência de exatamente um filtro na tabela é atendido pela mensagem especificada e adiciona os dados do filtro correspondente a uma coleção.Returns a value that indicates whether the match criterion of exactly one filter in the table is satisfied by the specified message, and adds the matching filter data to a collection.

public:
 bool GetMatchingValue(System::ServiceModel::Channels::Message ^ message, [Runtime::InteropServices::Out] TFilterData % data);
public bool GetMatchingValue (System.ServiceModel.Channels.Message message, out TFilterData data);
abstract member GetMatchingValue : System.ServiceModel.Channels.Message * 'FilterData -> bool

Parâmetros

message
Message Message Message Message

O Message a ser testado.The Message to test.

value
TFilterData TFilterData TFilterData TFilterData

Parâmetro out que armazena o FilterData que corresponde a message.out parameter that stores the FilterData that matches the message.

Retornos

true se o critério de correspondência de exatamente um filtro na tabela for atendido pela mensagem; false se nenhum filtro for atendido.true if the match criterion of exactly one filter in the table is satisfied by the message; false if no filter is satisfied.

Comentários

Use esse método quando for esperado que um único filtro corresponda à mensagem e apenas os dados de filtro do filtro de correspondência devem ser recuperados.Use this method when a single filter is expected to match the message and only the filter data from the matching filter must be recovered.

Esse método espera no máximo um único filtro de correspondência.This method expects at most a single matching filter. Se mais de um filtro corresponder, um MultipleFilterMatchesException deverá ser gerado.If more than one filter matches, a MultipleFilterMatchesException must be thrown.

Se o corpo da mensagem precisar ser inspecionado por um filtro na tabela de filtros, buffere a mensagem usando CreateBufferedCopy e passe-a para GetMatchingValue a versão do método.If the body of the message must be inspected by a filter in the filter table, buffer the message using CreateBufferedCopy and pass it to the GetMatchingValue 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 sobrecarga usa um Message e deve lançar um InvalidBodyAccessException se tentar examinar o corpo da mensagem.This overload takes a Message and must throw an InvalidBodyAccessException if it tries to examine the message body.

GetMatchingValue(MessageBuffer, TFilterData) GetMatchingValue(MessageBuffer, TFilterData) GetMatchingValue(MessageBuffer, TFilterData) GetMatchingValue(MessageBuffer, TFilterData)

Retorna um valor que indica se o critério de correspondência de exatamente um filtro na tabela é atendido pela mensagem em buffer especificada e adiciona os dados do filtro correspondente a uma coleção.Returns a value that indicates whether the match criterion of exactly one filter in the table is satisfied by the specified buffered message, and adds the matching filter data to a collection.

public:
 bool GetMatchingValue(System::ServiceModel::Channels::MessageBuffer ^ buffer, [Runtime::InteropServices::Out] TFilterData % data);
public bool GetMatchingValue (System.ServiceModel.Channels.MessageBuffer buffer, out TFilterData data);
abstract member GetMatchingValue : System.ServiceModel.Channels.MessageBuffer * 'FilterData -> bool
Public Function GetMatchingValue (buffer As MessageBuffer, ByRef data As TFilterData) As Boolean

Parâmetros

value
TFilterData TFilterData TFilterData TFilterData

Parâmetro out que armazena o FilterData que corresponde a messageBuffer.out parameter that stores the FilterData that matches the messageBuffer.

Retornos

true se o critério de correspondência de exatamente um filtro na tabela for atendido pela mensagem; false se nenhum filtro for atendido.true if the match criterion of exactly one filter in the table is satisfied by the message; false if no filter is satisfied.

Comentários

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

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.

Aplica-se a