XPathMessageFilterTable<TFilterData>.GetMatchingValue Método

Definição

Espaço de Nomes:: System.ServiceModel.Dispatcher

Assemblagem:: System.ServiceModel.dll

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 exatamente um XPathMessageFilter na tabela é satisfeito pelo objeto documento especificado e adiciona os dados do filtro correspondente a uma coleção.

Sobrecargas

Name	Description
GetMatchingValue(Message, TFilterData)	Devolve um valor que indica se o critério de correspondência de exatamente um XPathMessageFilter na tabela é satisfeito pela mensagem especificada e devolve os dados do filtro correspondentes.
GetMatchingValue(MessageBuffer, TFilterData)	Devolve um valor que indica se o critério de correspondência de exatamente um XPathMessageFilter na tabela é satisfeito pela mensagem em buffer especificada e devolve os dados correspondentes do filtro.
GetMatchingValue(SeekableXPathNavigator, TFilterData)	Devolve um valor que indica se o critério de correspondência exatamente um SeekableXPathNavigator na tabela é satisfeito pelo `navigator` e devolve os dados do filtro correspondente num `out` parâmetro.
GetMatchingValue(XPathNavigator, TFilterData)	Devolve um valor que indica se o critério de correspondência exatamente um XPathNavigator na tabela é satisfeito pelo `navigator` e devolve os dados do filtro correspondente num `out` parâmetro.

Observações

Use um destes quatro métodos quando se espera que um único filtro corresponda ao objeto documento e apenas o FilterData filtro correspondente deve ser recuperado.

Os dois primeiros métodos são implementações de GetMatchingValue.

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

Os dois métodos restantes são sobrecargas específicas para XPathMessageFilterTable<TFilterData>. Para filtrar num documento fornecido através de um navegador, use GetMatchingValue ou GetMatchingValue.

GetMatchingValue(Message, TFilterData)

Devolve um valor que indica se o critério de correspondência de exatamente um XPathMessageFilter na tabela é satisfeito pela mensagem especificada e devolve os dados do filtro correspondentes.

public:
 virtual 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
override this.GetMatchingValue : System.ServiceModel.Channels.Message * 'FilterData -> bool

Public Function GetMatchingValue (message As Message, ByRef data As TFilterData) As Boolean

Parâmetros

message: Message

O Message teste.

data: TFilterData

O out parâmetro que armazena o FilterData para o filtro que corresponde ao message.

Devoluções

Boolean

true se o critério de correspondência de um filtro na tabela for satisfeito pela mensagem; false se nenhum filtro for satisfeito.

Implementações

GetMatchingValue(Message, TFilterData)

Exceções

ArgumentNullException

message é null.

MultipleFilterMatchesException

Mais do que um filtro corresponde ao message.

Observações

Use este método quando se espera que um único filtro corresponda à mensagem e apenas o FilterData do filtro correspondente deve ser recuperado.

Este método implementa GetMatchingValue.

Aplica-se a

GetMatchingValue(MessageBuffer, TFilterData)

Devolve um valor que indica se o critério de correspondência de exatamente um XPathMessageFilter na tabela é satisfeito pela mensagem em buffer especificada e devolve os dados correspondentes do filtro.

public:
 virtual bool GetMatchingValue(System::ServiceModel::Channels::MessageBuffer ^ messageBuffer, [Runtime::InteropServices::Out] TFilterData % data);

public bool GetMatchingValue(System.ServiceModel.Channels.MessageBuffer messageBuffer, out TFilterData data);

abstract member GetMatchingValue : System.ServiceModel.Channels.MessageBuffer * 'FilterData -> bool
override this.GetMatchingValue : System.ServiceModel.Channels.MessageBuffer * 'FilterData -> bool

Public Function GetMatchingValue (messageBuffer As MessageBuffer, ByRef data As TFilterData) As Boolean

Parâmetros

messageBuffer: MessageBuffer

O MessageBuffer teste.

data: TFilterData

O out parâmetro que armazena o FilterData para o filtro que corresponde ao messageBuffer.

Devoluções

Boolean

true se o critério de correspondência de um filtro na tabela for satisfeito pela mensagem em buffer; false se nenhum filtro for satisfeito.

Implementações

GetMatchingValue(MessageBuffer, TFilterData)

Exceções

ArgumentNullException

message é null.

MultipleFilterMatchesException

Mais do que um filtro corresponde ao messageBuffer.

Observações

Use este método quando se espera que um único filtro corresponda à mensagem em buffer e apenas o FilterData do filtro correspondente tiver de ser recuperado.

Este método implementa GetMatchingFilter.

Aplica-se a

GetMatchingValue(SeekableXPathNavigator, TFilterData)

Devolve um valor que indica se o critério de correspondência exatamente um SeekableXPathNavigator na tabela é satisfeito pelo navigator e devolve os dados do filtro correspondente num out parâmetro.

public:
 bool GetMatchingValue(System::ServiceModel::Dispatcher::SeekableXPathNavigator ^ navigator, [Runtime::InteropServices::Out] TFilterData % data);

public bool GetMatchingValue(System.ServiceModel.Dispatcher.SeekableXPathNavigator navigator, out TFilterData data);

member this.GetMatchingValue : System.ServiceModel.Dispatcher.SeekableXPathNavigator * 'FilterData -> bool

Public Function GetMatchingValue (navigator As SeekableXPathNavigator, ByRef data As TFilterData) As Boolean

Parâmetros

navigator: SeekableXPathNavigator

O SeekableXPathNavigator teste.

data: TFilterData

O out parâmetro que armazena o FilterData que corresponde ao navigator.

Devoluções

Boolean

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

Exceções

ArgumentNullException

navigator é null.

MultipleFilterMatchesException

Mais do que um filtro corresponde ao navigator.

Observações

Use este método para especificar uma condição XPath que a mensagem deve cumprir.

Este método é semelhante a GetMatchingValue, exceto que usa um SeekableXPathNavigator, que estende a funcionalidade do XPathNavigator para incluir métodos que permitem várias otimizações.

Aplica-se a

GetMatchingValue(XPathNavigator, TFilterData)

Devolve um valor que indica se o critério de correspondência exatamente um XPathNavigator na tabela é satisfeito pelo navigator e devolve os dados do filtro correspondente num out parâmetro.

public:
 bool GetMatchingValue(System::Xml::XPath::XPathNavigator ^ navigator, [Runtime::InteropServices::Out] TFilterData % data);

public bool GetMatchingValue(System.Xml.XPath.XPathNavigator navigator, out TFilterData data);

member this.GetMatchingValue : System.Xml.XPath.XPathNavigator * 'FilterData -> bool

Public Function GetMatchingValue (navigator As XPathNavigator, ByRef data As TFilterData) As Boolean

Parâmetros

navigator: XPathNavigator

O XPathNavigator teste.

data: TFilterData

O out parâmetro que armazena o FilterData que corresponde ao navigator.

Devoluções

Boolean

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

Exceções

ArgumentNullException

navigator é null.

MultipleFilterMatchesException

Mais do que um filtro corresponde ao navigator.

Observações

Use este método para especificar uma condição XPath que a mensagem deve cumprir.

Aplica-se a

Comentários

Esta página foi útil?