XPathMessageFilterTable<TFilterData>.GetMatchingFilter 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 filtro na tabela é atendido pela mensagem especificada ou pela mensagem armazenada em buffer e retorna esse filtro em um parâmetro out.

Sobrecargas

GetMatchingFilter(Message, MessageFilter)	Retorna um valor que indica se o critério de correspondência de exatamente um filtro na tabela é atendido pela mensagem especificada e retorna esse filtro em um parâmetro out.
GetMatchingFilter(MessageBuffer, MessageFilter)	Retorna um valor que indica se o critério de correspondência de exatamente um filtro na tabela é atendido pela mensagem especificada ou pela mensagem armazenada em buffer e retorna esse filtro em um parâmetro out.
GetMatchingFilter(SeekableXPathNavigator, MessageFilter)	Retorna um valor que indica se o critério de correspondência de exatamente um SeekableXPathNavigator na tabela é atendido pela mensagem especificada ou pela mensagem armazenada em buffer e retorna esse filtro em um parâmetro out.
GetMatchingFilter(XPathNavigator, MessageFilter)	Retorna um valor que indica se o critério de correspondência de exatamente um XPathNavigator na tabela é atendido pela mensagem especificada ou pela mensagem armazenada em buffer e retorna esse filtro em um parâmetro out.

Comentários

Testa se uma mensagem satisfaz exatamente um dos filtros na tabela de filtros.

GetMatchingFilter(Message, MessageFilter)

Retorna um valor que indica se o critério de correspondência de exatamente um filtro na tabela é atendido pela mensagem especificada e retorna esse filtro em um parâmetro out.

public:
 virtual bool GetMatchingFilter(System::ServiceModel::Channels::Message ^ message, [Runtime::InteropServices::Out] System::ServiceModel::Dispatcher::MessageFilter ^ % filter);

public bool GetMatchingFilter (System.ServiceModel.Channels.Message message, out System.ServiceModel.Dispatcher.MessageFilter filter);

abstract member GetMatchingFilter : System.ServiceModel.Channels.Message * MessageFilter -> bool
override this.GetMatchingFilter : System.ServiceModel.Channels.Message * MessageFilter -> bool

Public Function GetMatchingFilter (message As Message, ByRef filter As MessageFilter) As Boolean

Parâmetros

message

Message

O Message a ser testado.

filter

MessageFilter

O parâmetro out que armazena o filtro que é atendido pela message. Se não for encontrado nenhum filtro, o parâmetro será definido como seu valor padrão.

Retornos

Boolean

O MessageFilter cujos critérios de consulta são atendidos pela mensagem ou null se não for encontrado nenhum filtro para corresponder.

Implementações

GetMatchingFilter(Message, MessageFilter)

Exceções

ArgumentNullException

message é null.

MultipleFilterMatchesException

Mais de um filtro corresponde a message.

InvalidBodyAccessException

Um filtro tentou examinar o conteúdo do corpo da mensagem.

Comentários

Use esse método quando um único filtro for esperado para corresponder à mensagem e o filtro correspondente for necessário.

Esse método testa uma única correspondência de filtro no bucket de maior prioridade de filtros. Os filtros na tabela não têm permissão para inspecionar o corpo da mensagem.

Se mais de um filtro for esperado para corresponder à mensagem, use o GetMatchingFilters.

Esse método implementa GetMatchingFilter.

GetMatchingFilter(MessageBuffer, MessageFilter)

Retorna um valor que indica se o critério de correspondência de exatamente um filtro na tabela é atendido pela mensagem especificada ou pela mensagem armazenada em buffer e retorna esse filtro em um parâmetro out.

public:
 virtual bool GetMatchingFilter(System::ServiceModel::Channels::MessageBuffer ^ messageBuffer, [Runtime::InteropServices::Out] System::ServiceModel::Dispatcher::MessageFilter ^ % filter);

public bool GetMatchingFilter (System.ServiceModel.Channels.MessageBuffer messageBuffer, out System.ServiceModel.Dispatcher.MessageFilter filter);

abstract member GetMatchingFilter : System.ServiceModel.Channels.MessageBuffer * MessageFilter -> bool
override this.GetMatchingFilter : System.ServiceModel.Channels.MessageBuffer * MessageFilter -> bool

Public Function GetMatchingFilter (messageBuffer As MessageBuffer, ByRef filter As MessageFilter) As Boolean

Parâmetros

messageBuffer

MessageBuffer

O MessageBuffer a ser testado.

filter

MessageFilter

O parâmetro out que armazena o filtro que é atendido pela message. Se não for encontrado nenhum filtro, o parâmetro será definido como seu valor padrão.

Retornos

Boolean

O MessageFilter cujos critérios de consulta são atendidos pela mensagem armazenada em buffer ou null se não for encontrado nenhum filtro para corresponder.

Implementações

GetMatchingFilter(MessageBuffer, MessageFilter)

Exceções

ArgumentNullException

messageBuffer é null.

MultipleFilterMatchesException

Mais de um filtro corresponde a messageBuffer.

Comentários

Use esse método quando um único filtro for esperado para corresponder à mensagem em buffer e o filtro correspondente for necessário.

Os filtros na tabela têm permissão para inspecionar o corpo da mensagem.

Se mais de um filtro for esperado para corresponder à mensagem, use o GetMatchingFilters.

Esse método implementa GetMatchingFilter.

GetMatchingFilter(SeekableXPathNavigator, MessageFilter)

Retorna um valor que indica se o critério de correspondência de exatamente um SeekableXPathNavigator na tabela é atendido pela mensagem especificada ou pela mensagem armazenada em buffer e retorna esse filtro em um parâmetro out.

public:
 bool GetMatchingFilter(System::ServiceModel::Dispatcher::SeekableXPathNavigator ^ navigator, [Runtime::InteropServices::Out] System::ServiceModel::Dispatcher::MessageFilter ^ % filter);

public bool GetMatchingFilter (System.ServiceModel.Dispatcher.SeekableXPathNavigator navigator, out System.ServiceModel.Dispatcher.MessageFilter filter);

member this.GetMatchingFilter : System.ServiceModel.Dispatcher.SeekableXPathNavigator * MessageFilter -> bool

Public Function GetMatchingFilter (navigator As SeekableXPathNavigator, ByRef filter As MessageFilter) As Boolean

Parâmetros

navigator

SeekableXPathNavigator

O SeekableXPathNavigator a ser testado.

filter

MessageFilter

O parâmetro out que armazena o filtro que é atendido pela message. Se não for encontrado nenhum filtro, o parâmetro será definido como seu valor padrão.

Retornos

Boolean

O MessageFilter cujos critérios de consulta são atendidos pelo navegador ou null se não for encontrado nenhum filtro para corresponder.

Exceções

ArgumentNullException

navigator é null.

MultipleFilterMatchesException

Mais de um filtro corresponde a navigator.

Comentários

Use esse método quando se espera que um único filtro corresponda à mensagem especificada pelo SeekableXPathNavigator filtro correspondente.

Se mais de um filtro for esperado para corresponder à mensagem, use o GetMatchingFilters.

GetMatchingFilter(XPathNavigator, MessageFilter)

Retorna um valor que indica se o critério de correspondência de exatamente um XPathNavigator na tabela é atendido pela mensagem especificada ou pela mensagem armazenada em buffer e retorna esse filtro em um parâmetro out.

public:
 bool GetMatchingFilter(System::Xml::XPath::XPathNavigator ^ navigator, [Runtime::InteropServices::Out] System::ServiceModel::Dispatcher::MessageFilter ^ % filter);

public bool GetMatchingFilter (System.Xml.XPath.XPathNavigator navigator, out System.ServiceModel.Dispatcher.MessageFilter filter);

member this.GetMatchingFilter : System.Xml.XPath.XPathNavigator * MessageFilter -> bool

Public Function GetMatchingFilter (navigator As XPathNavigator, ByRef filter As MessageFilter) As Boolean

Parâmetros

navigator

XPathNavigator

O XPathNavigator a ser testado.

filter

MessageFilter

O parâmetro out que armazena o filtro que é atendido pela navigator. Se não for encontrado nenhum filtro, o parâmetro será definido como seu valor padrão.

Retornos

Boolean

O MessageFilter cujos critérios de consulta são atendidos pelo navegador ou null se não for encontrado nenhum filtro para corresponder.

Exceções

ArgumentNullException

navigator é null.

MultipleFilterMatchesException

Mais de um filtro corresponde a navigator.

Comentários

Use esse método quando se espera que um único filtro corresponda à mensagem especificada pelo XPathNavigator filtro correspondente.

Se mais de um filtro for esperado para corresponder à mensagem, use o GetMatchingFilters.