XPathMessageFilterTable<TFilterData>.GetMatchingFilter Méthode

Définition

Espace de noms:

System.ServiceModel.Dispatcher

Assembly:

System.ServiceModel.dll

Retourne une valeur qui indique si le message ou le message mis en mémoire tampon indiqué respecte le critère de correspondance d'un filtre dans la table, et retourne le filtre dans un paramètre out.

Surcharges

GetMatchingFilter(Message, MessageFilter)	Retourne une valeur qui indique si le message spécifié respecte le critère de correspondance d'un filtre dans la table, et retourne le filtre dans un paramètre out.
GetMatchingFilter(MessageBuffer, MessageFilter)	Retourne une valeur qui indique si le message ou le message mis en mémoire tampon indiqué respecte le critère de correspondance d'un filtre dans la table, et retourne le filtre dans un paramètre out.
GetMatchingFilter(SeekableXPathNavigator, MessageFilter)	Retourne une valeur qui indique si le message ou le message mis en mémoire tampon indiqué respecte le critère de correspondance d'une occurrence de SeekableXPathNavigator dans la table, et retourne ce filtre dans un paramètre out.
GetMatchingFilter(XPathNavigator, MessageFilter)	Retourne une valeur qui indique si le message ou le message mis en mémoire tampon indiqué respecte le critère de correspondance d'une occurrence de XPathNavigator dans la table, et retourne ce filtre dans un paramètre out.

Remarques

Teste si un message répond à exactement l'un des filtres dans la table de filtres.

GetMatchingFilter(Message, MessageFilter)

Retourne une valeur qui indique si le message spécifié respecte le critère de correspondance d'un filtre dans la table, et retourne le filtre dans un paramètre 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

Paramètres

message

Message

Message à tester.

filter

MessageFilter

Paramètre out qui stocke le filtre respecté par message. Si aucun filtre n'a été trouvé, le paramètre est défini à sa valeur par défaut.

Retours

Boolean

MessageFilter dont les critères de requête sont respectés par le message ou null si aucun filtre correspondant n'a été trouvé.

Implémente

GetMatchingFilter(Message, MessageFilter)

Exceptions

ArgumentNullException

message a la valeur null.

MultipleFilterMatchesException

Plusieurs filtres correspondent à message.

InvalidBodyAccessException

Un filtre a essayé d'examiner le contenu du corps du message.

Remarques

Utilisez cette méthode lorsqu'un filtre unique est supposé correspondre au message et que le filtre correspondant est requis.

Cette méthode teste une correspondance de filtre unique dans le compartiment de filtres à priorité la plus élevé. Les filtres de la table ne peuvent pas inspecter le corps du message.

Si plusieurs filtres sont supposés correspondre au message, utilisez GetMatchingFilters.

Cette méthode implémente GetMatchingFilter.

GetMatchingFilter(MessageBuffer, MessageFilter)

Retourne une valeur qui indique si le message ou le message mis en mémoire tampon indiqué respecte le critère de correspondance d'un filtre dans la table, et retourne le filtre dans un paramètre 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

Paramètres

messageBuffer

MessageBuffer

MessageBuffer à tester.

filter

MessageFilter

Paramètre out qui stocke le filtre respecté par message. Si aucun filtre n'a été trouvé, le paramètre est défini à sa valeur par défaut.

Retours

Boolean

MessageFilter dont les critères de requête sont respectés par le message mis en mémoire tampon ou null si aucun filtre correspondant n'a été trouvé.

Implémente

GetMatchingFilter(MessageBuffer, MessageFilter)

Exceptions

ArgumentNullException

messageBuffer a la valeur null.

MultipleFilterMatchesException

Plusieurs filtres correspondent à messageBuffer.

Remarques

Utilisez cette méthode lorsqu'un filtre unique est supposé correspondre au message mis en mémoire tampon et que le filtre correspondant est requis.

Les filtres de la table peuvent inspecter le corps du message.

Si plusieurs filtres sont supposés correspondre au message, utilisez GetMatchingFilters.

Cette méthode implémente GetMatchingFilter.

GetMatchingFilter(SeekableXPathNavigator, MessageFilter)

Retourne une valeur qui indique si le message ou le message mis en mémoire tampon indiqué respecte le critère de correspondance d'une occurrence de SeekableXPathNavigator dans la table, et retourne ce filtre dans un paramètre 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

Paramètres

navigator

SeekableXPathNavigator

SeekableXPathNavigator à tester.

filter

MessageFilter

Paramètre out qui stocke le filtre respecté par message. Si aucun filtre n'a été trouvé, le paramètre est défini à sa valeur par défaut.

Retours

Boolean

MessageFilter dont les critères de requête sont respectés par le navigateur ou null si aucun filtre correspondant n'a été trouvé.

Exceptions

ArgumentNullException

navigator a la valeur null.

MultipleFilterMatchesException

Plusieurs filtres correspondent à navigator.

Remarques

Utilisez cette méthode lorsqu'un filtre unique est supposé correspondre au message spécifié par SeekableXPathNavigator et que le filtre correspondant est requis.

Si plusieurs filtres sont supposés correspondre au message, utilisez GetMatchingFilters.

GetMatchingFilter(XPathNavigator, MessageFilter)

Retourne une valeur qui indique si le message ou le message mis en mémoire tampon indiqué respecte le critère de correspondance d'une occurrence de XPathNavigator dans la table, et retourne ce filtre dans un paramètre 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

Paramètres

navigator

XPathNavigator

XPathNavigator à tester.

filter

MessageFilter

Paramètre out qui stocke le filtre respecté par navigator. Si aucun filtre n'a été trouvé, le paramètre est défini à sa valeur par défaut.

Retours

Boolean

MessageFilter dont les critères de requête sont respectés par le navigateur ou null si aucun filtre correspondant n'a été trouvé.

Exceptions

ArgumentNullException

navigator a la valeur null.

MultipleFilterMatchesException

Plusieurs filtres correspondent à navigator.

Remarques

Utilisez cette méthode lorsqu'un filtre unique est supposé correspondre au message spécifié par XPathNavigator et que le filtre correspondant est requis.

Si plusieurs filtres sont supposés correspondre au message, utilisez GetMatchingFilters.