XPathMessageFilter.Match Método

Definição

Namespace:

System.ServiceModel.Dispatcher

Assembly:

System.ServiceModel.dll

Determina se uma mensagem ou documento XML satisfaz os critérios de consulta do filtro XPath.

Sobrecargas

Match(Message)	Testa se uma mensagem especificada satisfaz os critérios do filtro XPath. Este formulário não tem permissão para acessar o corpo da mensagem.
Match(MessageBuffer)	Determina se uma mensagem armazenada em buffer satisfaz os critérios de consulta do filtro XPath.
Match(SeekableXPathNavigator)	Determina se o documento XML fornecido pelo navegador XPath otimizado especificado satisfaz os critérios de consulta do filtro XPath.
Match(XPathNavigator)	Avalia o filtro no navegador XPath especificado.

Comentários

Esses métodos verificam um filtro em relação a uma mensagem. Se você precisar verificar a mensagem em vários filtros, coloque os filtros em uma tabela de filtro e use os métodos de correspondência fornecidos pela tabela.

Se você só precisar testar os cabeçalhos da mensagem e não o corpo da mensagem, use o Match método .

Se você precisar testar partes do corpo da mensagem, use o Match método .

Para testes que envolvem consultas XPath, use uma das sobrecargas restantes do Match.

Match(Message)

Testa se uma mensagem especificada satisfaz os critérios do filtro XPath. Este formulário não tem permissão para acessar o corpo da mensagem.

public:
 override bool Match(System::ServiceModel::Channels::Message ^ message);

public override bool Match (System.ServiceModel.Channels.Message message);

override this.Match : System.ServiceModel.Channels.Message -> bool

Public Overrides Function Match (message As Message) As Boolean

Parâmetros

message

Message

O Message a ser testado.

Retornos

Boolean

true se o Message satisfaz os critérios de filtro, caso contrário, false.

Exceções

ArgumentNullException

message é null.

InvalidBodyAccessException

A avaliação de XPath tentada para examinar o corpo da mensagem.

XPathException

Ocorreu um erro de compilador.

Comentários

Use o XPathMessageFilter.Match método para corresponder elementos do corpo. Uma exceção será gerada por esse método se o mecanismo tentar acessar o corpo da mensagem para avaliar a expressão XPath. Isso ajuda a garantir que o mecanismo de filtro não acesse o fluxo do corpo.

Match(MessageBuffer)

Determina se uma mensagem armazenada em buffer satisfaz os critérios de consulta do filtro XPath.

public:
 override bool Match(System::ServiceModel::Channels::MessageBuffer ^ messageBuffer);

public override bool Match (System.ServiceModel.Channels.MessageBuffer messageBuffer);

override this.Match : System.ServiceModel.Channels.MessageBuffer -> bool

Public Overrides Function Match (messageBuffer As MessageBuffer) As Boolean

Parâmetros

messageBuffer

MessageBuffer

O MessageBuffer a ser testado.

Retornos

Boolean

true se o Match(MessageBuffer) satisfaz os critérios de filtro, caso contrário, false.

Exceções

ArgumentNullException

message é null.

XPathException

Ocorreu um erro de compilador.

Comentários

Use essa sobrecarga do Match método quando um MessageBuffer estiver disponível. Esse formulário tem permissão para examinar o corpo da mensagem.

Match(SeekableXPathNavigator)

Determina se o documento XML fornecido pelo navegador XPath otimizado especificado satisfaz os critérios de consulta do filtro XPath.

public:
 bool Match(System::ServiceModel::Dispatcher::SeekableXPathNavigator ^ navigator);

public bool Match (System.ServiceModel.Dispatcher.SeekableXPathNavigator navigator);

override this.Match : System.ServiceModel.Dispatcher.SeekableXPathNavigator -> bool

Public Function Match (navigator As SeekableXPathNavigator) As Boolean

Parâmetros

navigator

SeekableXPathNavigator

O SeekableXPathNavigator que fornece dados para serem testados.

Retornos

Boolean

true se os dados do SeekableXPathNavigator satisfazem os critérios do filtro, caso contrário, false.

Exceções

ArgumentNullException

navigator é null.

XPathException

Ocorreu um erro de compilador.

Comentários

A SeekableXPathNavigator classe estende a XPathNavigator classe com métodos que executam consultas com mais eficiência.

Match(XPathNavigator)

Avalia o filtro no navegador XPath especificado.

public:
 bool Match(System::Xml::XPath::XPathNavigator ^ navigator);

public bool Match (System.Xml.XPath.XPathNavigator navigator);

override this.Match : System.Xml.XPath.XPathNavigator -> bool

Public Function Match (navigator As XPathNavigator) As Boolean

Parâmetros

navigator

XPathNavigator

O XPathNavigator que fornece dados para serem testados.

Retornos

Boolean

true se os dados do XPathNavigator satisfazem os critérios do filtro, caso contrário, false.

Exceções

ArgumentNullException

navigator é null.

XPathException

Ocorreu um erro de compilador.