XPathMessageFilterTable<TFilterData>.GetMatchingValue Método

Definição

Namespace:

System.ServiceModel.Dispatcher

Assembly:

System.ServiceModel.dll

Retorna um valor que indica se o critério de correspondência de exatamente um XPathMessageFilter na tabela é atendido pelo objeto de documento especificado e adiciona os dados do filtro correspondente a uma coleção.

Sobrecargas

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

Comentários

Use um desses quatro métodos quando se espera que um único filtro corresponda ao objeto do documento e somente o FilterData do 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 pode exigir exame.

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

GetMatchingValue(Message, TFilterData)

Retorna um valor que indica se o critério de correspondência de exatamente um XPathMessageFilter na tabela é atendido pela mensagem especificada e retorna os dados de 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 a ser testado.

data

TFilterData

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

Retornos

Boolean

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

Implementações

GetMatchingValue(Message, TFilterData)

Exceções

ArgumentNullException

message é null.

MultipleFilterMatchesException

Mais de um filtro corresponde a message.

Comentários

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

Esse método implementa GetMatchingValue.

GetMatchingValue(MessageBuffer, TFilterData)

Retorna um valor que indica se o critério de correspondência de exatamente um XPathMessageFilter na tabela é atendido pela mensagem armazenada em buffer especificada e retorna os dados de filtro correspondentes.

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 a ser testado.

data

TFilterData

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

Retornos

Boolean

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

Implementações

GetMatchingValue(MessageBuffer, TFilterData)

Exceções

ArgumentNullException

message é null.

MultipleFilterMatchesException

Mais de um filtro corresponde a messageBuffer.

Comentários

Use esse método quando se espera que um único filtro corresponda à mensagem em buffer e somente o FilterData filtro correspondente deve ser recuperado.

Esse método implementa GetMatchingFilter.

GetMatchingValue(SeekableXPathNavigator, TFilterData)

Retorna um valor que indica se o critério de correspondência de exatamente um SeekableXPathNavigator na tabela é atendido pelo navigator e retorna os dados de filtro do filtro correspondente em um parâmetro out.

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 a ser testado.

data

TFilterData

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

Retornos

Boolean

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

Exceções

ArgumentNullException

navigator é null.

MultipleFilterMatchesException

Mais de um filtro corresponde a navigator.

Comentários

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

Esse método é semelhante a GetMatchingValue, exceto que ele usa um SeekableXPathNavigator, que estende a funcionalidade dos XPathNavigator métodos de inclusão que permitem várias otimizações.

GetMatchingValue(XPathNavigator, TFilterData)

Retorna um valor que indica se o critério de correspondência de exatamente um XPathNavigator na tabela é atendido pelo navigator e retorna os dados de filtro do filtro correspondente em um parâmetro out.

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 a ser testado.

data

TFilterData

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

Retornos

Boolean

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

Exceções

ArgumentNullException

navigator é null.

MultipleFilterMatchesException

Mais de um filtro corresponde a navigator.

Comentários

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