XPathMessageFilter Classe

Définition

Espace de noms:
System.ServiceModel.Dispatcher
Assembly:
System.ServiceModel.dll

Représente une requête sur un document XML défini par une expression XPath 1.0.

public ref class XPathMessageFilter : System::ServiceModel::Dispatcher::MessageFilter, System::Xml::Serialization::IXmlSerializable
public class XPathMessageFilter : System.ServiceModel.Dispatcher.MessageFilter, System.Xml.Serialization.IXmlSerializable
type XPathMessageFilter = class
    inherit MessageFilter
    interface IXmlSerializable
Public Class XPathMessageFilter
Inherits MessageFilter
Implements IXmlSerializable
Héritage
Object
MessageFilter
XPathMessageFilter
Implémente
IXmlSerializable

Remarques

Une XPathMessageFilter expression XPath permet de déterminer si un document XML contient des éléments, des attributs, du texte ou d’autres constructions syntaxiques XML. En règle générale, une application utilise un XPathMessageFilter point de terminaison pour interroger le contenu d’un message SOAP, puis prend l’action appropriée en fonction des résultats de cette requête. Par exemple, un processus de mise en file d’attente peut utiliser une requête XPath pour vérifier l’élément de priorité d’un en-tête connu pour décider s’il faut déplacer un message vers l’avant de la file d’attente.

Le langage XPath (XML Path Language) fournit un langage permettant d’adresser des parties d’un document XML. La construction syntactique principale dans XPath est une expression qui définit comment parcourir la structure logique d’un document ET d’une adresse XML ou identifier un type de données XPath. Plus précisément, les implémentations XPath évaluent une expression par rapport à la structure d’un document XML pour générer l’un des quatre types de données XPath de base : chaînes, nombres, booléens et jeux de nœuds. Ils prennent également en charge les fonctions qui convertissent un type de données XPath en type de données chaîne, nombre ou booléen. Si une méthode attend l’un de ces trois types de données, le résultat de l’évaluation de l’expression est implicitement converti. Notez que ces trois types de données ne peuvent pas être convertis en type de jeu de nœuds. Le langage de chemin XML est entièrement décrit dans la spécification W3C XML Path Language 1.0.

Les nombres dans les expressions XPath sont exprimés sous forme de valeurs 64 bits double précision. Par conséquent, les expressions XPath qui impliquent des nombres de tests avec de nombreux chiffres significatifs peuvent retourner des résultats incorrects en raison de problèmes de précision à virgule flottante. Pour plus d’informations, consultez la version 1.0 du langage XPath (XML Path Language), section 3.5.

Constructeurs

Nom Description
XPathMessageFilter()

Initialise une nouvelle instance de la XPathMessageFilter classe qui correspond à tous les documents XML bien formés.
XPathMessageFilter(String, XmlNamespaceManager)

Initialise une nouvelle instance de la XPathMessageFilter classe à l’aide de l’expression XPath et du gestionnaire d’espaces de noms spécifiés.
XPathMessageFilter(String, XsltContext)

Initialise une nouvelle instance de la classe à l’aide XPathMessageFilter d’une expression XPath spécifiée et XsltContext.
XPathMessageFilter(String)

Initialise une nouvelle instance de la classe à l’aide XPathMessageFilter d’une expression XPath pour spécifier des critères de requête pour le filtre.
XPathMessageFilter(XmlReader, XmlNamespaceManager)

Initialise une nouvelle instance de la XPathMessageFilter classe en lisant dans un XPath diffusé en continu avec un lecteur XML spécifié et en utilisant le gestionnaire d’espaces de noms spécifié.
XPathMessageFilter(XmlReader, XsltContext)

Initialise une nouvelle instance de la XPathMessageFilter classe en lisant un XPath diffusé en continu avec un lecteur XML spécifié et en utilisant les XsltContext espaces de noms, les fonctions personnalisées et les variables.
XPathMessageFilter(XmlReader)

Initialise une nouvelle instance de la XPathMessageFilter classe en lisant un XPath diffusé en continu avec le lecteur XML spécifié.

Propriétés

Nom Description
Namespaces

Obtient le gestionnaire qui résout les préfixes d’espace de noms dans l’expression XPath qui définit le filtre.
NodeQuota

Obtient ou définit le nombre maximal de nœuds qui doivent être examinés lors de l’évaluation du filtre.
XPath

Obtient l’expression XPath qui définit les critères de requête du filtre.

Méthodes

Nom Description
CreateFilterTable<FilterData>()

Crée un XPathMessageFilterTable<TFilterData> type de données spécifié associé à celui-ci.
Equals(Object)

Détermine si l’objet spécifié est égal à l’objet actuel.

(Hérité de Object)
GetHashCode()

Sert de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient la Type de l’instance actuelle.

(Hérité de Object)
Match(Message)

Teste si un message spécifié répond aux critères du filtre XPath. Ce formulaire n’est pas autorisé à accéder au corps du message.
Match(MessageBuffer)

Détermine si un message mis en mémoire tampon répond aux critères de requête du filtre XPath.
Match(SeekableXPathNavigator)

Détermine si le document XML fourni par le navigateur XPath optimisé spécifié répond aux critères de requête du filtre XPath.
Match(XPathNavigator)

Évalue le filtre sur le navigateur XPath spécifié.
MemberwiseClone()

Crée une copie superficielle du Objectactuel.

(Hérité de Object)
OnGetSchema()

Obtient le schéma du document XML actif.
OnReadXml(XmlReader)

Lit le nœud XML actuel.
OnWriteXml(XmlWriter)

Écrit un nœud à l’aide writerde .
ReadXPath(XmlReader, XmlNamespaceManager)

Initialise l’instance actuelle de l’instance XPathMessageFilter avec un XPath obtenu à partir d’un lecteur XML spécifié à l’aide d’un gestionnaire d’espaces de noms spécifié.
StaticGetSchema(XmlSchemaSet)

Obtient le type de schéma XML utilisé pour sérialiser le filtre XPath.
ToString()

Retourne une chaîne qui représente l’objet actuel.

(Hérité de Object)
TrimToSize()

Compacte le filtre XPath, qui libère toutes les mémoires inutilisées.
WriteXPath(XmlWriter, IXmlNamespaceResolver)

Sérialise le filtre XPath en un XmlWriter.
WriteXPathTo(XmlWriter, String, String, String, Boolean)

Écrit l’élément XPath XML avec un enregistreur XML spécifié.

Implémentations d’interfaces explicites

Nom Description
IXmlSerializable.GetSchema()

Implémentation d’interface explicite qui obtient le schéma actuel.
IXmlSerializable.ReadXml(XmlReader)

Implémentation d’interface explicite qui lit le nœud XML actuel.
IXmlSerializable.WriteXml(XmlWriter)

Implémentation d’interface explicite qui écrit un nœud XML à l’aide writerde .

S’applique à