XPathMessageFilter Class

Definition

Représente une requête sur un document XML défini par une expression XPath 1.0.Represents a query on an XML document defined by an XPath 1.0 expression.

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
Inheritance
XPathMessageFilter
Implements

Remarks

Un XPathMessageFilter utilise une expression XPath pour déterminer si un document XML contient des éléments, des attributs, du texte ou d'autre constructions syntaxiques XML spécifiques.An XPathMessageFilter uses an XPath expression to determine whether an XML document contains specific elements, attributes, text, or other XML syntactic constructs. En général, une application utilise un XPathMessageFilter à un point de terminaison pour interroger le contenu d'un message SOAP puis prend la mesure appropriée en fonction des résultats de cette requête.Typically, an application uses an XPathMessageFilter at an endpoint to query the contents of a SOAP message and then takes the appropriate action based on the results of that query. 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 afin de décider s’il faut déplacer un message en haut de la file d’attente.A queuing process, for example, may use an XPath query to check the priority element of a known header to decide whether to move a message to the front of the queue.

XML Path Language (XPath) fournit un langage pour adresser des parties d'un document XML.The XML Path Language (XPath) provides a language for addressing parts of an XML document. La construction syntaxique primaire dans XPath est une expression qui définit comment parcourir la structure logique d’un document XML et adresser ou identifier un type de données XPath.The primary syntactic construct in XPath is an expression that defines how to traverse the logical structure of an XML document and address or identify an XPath data type. Spécifiquement, les implémentations de 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éen et jeux de nœuds.Specifically, XPath implementations evaluate an expression against the structure of an XML document to yield one of the four basic XPath data types: strings, numbers, Booleans, and node sets. Elles prennent également en charge des fonctions qui convertissent un type de données XPath en une chaîne, un nombre ou un type de données Booléen.They also support functions that convert an XPath data type to a string, number, or Boolean data type. Si une méthode attend l'un de ces trois types de données, le résultat de l'évaluation d'une expression est converti implicitement.If a method expects one of these three data types, the result of the expression evaluation is implicitly converted. Notez que ces trois types de données ne peuvent pas être convertis en un type défini par nœud.Note that these three data types cannot be converted to a node-set type. Le langage XML Path est entièrement décrit dans la spécification W3C XML Path language 1,0.The XML Path language is fully described in the W3C XML Path Language 1.0 specification.

Les nombres dans les expressions XPath sont exprimés sous forme de valeurs 64 bits en double précision.Numbers in XPath expressions are expressed as double-precision 64-bit values. Par conséquent, les expressions XPath qui impliquent des tests sur des nombres comportant de nombreux bits significatifs peuvent retourner des résultats incorrects en raison de problèmes de précision en virgule flottante.Therefore XPath expressions that involve testing numbers with many significant digits can return incorrect results due to floating point precision issues. Pour plus d’informations, consultez XML Path Language (XPath) Version 1,0, section 3,5.For more information, see XML Path Language (XPath) Version 1.0, section 3.5.

Constructors

XPathMessageFilter()

Initialise une nouvelle instance de la classe XPathMessageFilter qui correspond à tous les documents XML bien formés.Initializes a new instance of the XPathMessageFilter class that matches all well-formed XML documents.

XPathMessageFilter(String)

Initialise une nouvelle instance de la classe XPathMessageFilter à l'aide d'une expression XPath pour spécifier les critères de requête du filtre.Initializes a new instance of the XPathMessageFilter class using an XPath expression to specify query criteria for the filter.

XPathMessageFilter(String, XmlNamespaceManager)

Initialise une nouvelle instance de la classe XPathMessageFilter à l'aide de l'expression XPath et du gestionnaire d'espaces de noms spécifié.Initializes a new instance of the XPathMessageFilter class using the specified XPath expression and namespace manager.

XPathMessageFilter(String, XsltContext)

Initialise une nouvelle instance de la classe XPathMessageFilter à l'aide d'une expression XPath spécifiée et de XsltContext.Initializes a new instance of the XPathMessageFilter class using a specified XPath expression and XsltContext.

XPathMessageFilter(XmlReader)

Initialise une nouvelle instance de la classe XPathMessageFilter en lisant dans un XPath transmis en continu à l’aide du lecteur XML spécifié.Initializes a new instance of the XPathMessageFilter class by reading a streamed XPath with the specified XML reader.

XPathMessageFilter(XmlReader, XmlNamespaceManager)

Initialise une nouvelle instance de la classe XPathMessageFilter en lisant un XPath transmis en continu avec un lecteur XML spécifié et à l’aide du gestionnaire d’espace de noms spécifié.Initializes a new instance of the XPathMessageFilter class by reading in a streamed XPath with a specified XML reader and using the specified namespace manager.

XPathMessageFilter(XmlReader, XsltContext)

Initialise une nouvelle instance de la classe XPathMessageFilter en lisant un XPath transmis en continu à l’aide d’un lecteur XML spécifié et en faisant appel à XsltContext pour résoudre des espaces de noms, des fonctions personnalisées et des variables.Initializes a new instance of the XPathMessageFilter class by reading a streamed XPath with a specified XML reader and using the XsltContext to resolve namespaces, custom functions, and variables.

Properties

Namespaces

Obtient le gestionnaire qui résout les préfixes d’espace de noms dans l’expression XPath qui définit le filtre.Gets the manager that resolves namespace prefixes in the XPath expression that defines the filter.

NodeQuota

Obtient ou définit le nombre maximal de nœuds qui doivent être examinés pendant l'évaluation de filtre.Gets or sets the maximum number of nodes that should be looked at during filter evaluation.

XPath

Obtient l’expression XPath qui définit les critères de requête pour le filtre.Gets the XPath expression that defines the query criteria for the filter.

Methods

CreateFilterTable<FilterData>()

Crée un XPathMessageFilterTable<TFilterData> auquel un type de données spécifié est associé.Creates an XPathMessageFilterTable<TFilterData> that has a specified type of data associated with it.

Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Inherited from Object)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Inherited from Object)
Match(Message)

Teste si un message spécifié satisfait aux critères du filtre XPath.Tests whether a specified message satisfies the criteria of the XPath filter. Ce formulaire n'est pas autorisé à accéder au corps du message.This form is not allowed to access the body of the message.

Match(MessageBuffer)

Détermine si un message mis en mémoire tampon satisfait aux critères de requête du filtre XPath.Determines whether a buffered message satisfies the query criteria of the XPath filter.

Match(SeekableXPathNavigator)

Détermine si le document XML fourni par le navigateur XPath optimisé spécifié satisfait aux critères de requête du filtre XPath.Determines whether the XML document provided by the specified optimized XPath navigator satisfies the query criteria of the XPath filter.

Match(XPathNavigator)

Évalue le filtre sur le navigateur XPath spécifié.Evaluates the filter over the specified XPath navigator.

MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Inherited from Object)
OnGetSchema()

Obtient le schéma pour le document XML actuel.Gets the schema for the current XML document.

OnReadXml(XmlReader)

Lit le nœud XML actif.Reads the current XML node.

OnWriteXml(XmlWriter)

Écrit un nœud à l'aide de writer.Writes a node using writer.

ReadXPath(XmlReader, XmlNamespaceManager)

Initialise l'instance actuelle du XPathMessageFilter avec un XPath obtenu d'un lecteur XML indiqué à l'aide d'un gestionnaire d'espace de noms spécifié.Initializes the current instance of the XPathMessageFilter with an XPath obtained from a specified XML reader using a specified namespace manager.

StaticGetSchema(XmlSchemaSet)

Obtient le type de schéma XML utilisé pour sérialiser le filtre XPath.Gets the type of XML schema used to serialize the XPath filter.

ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Inherited from Object)
TrimToSize()

Condense le filtre XPath, qui libère toute la mémoire inutilisée.Compacts the XPath filter, which releases all unused memory.

WriteXPath(XmlWriter, IXmlNamespaceResolver)

Sérialise le filtre de XPath sur XmlWriter.Serializes the XPath filter to an XmlWriter.

WriteXPathTo(XmlWriter, String, String, String, Boolean)

Écrit l'élément XML XPath avec un enregistreur XML spécifié.Writes the XML XPath element with a specified XML writer.

Explicit Interface Implementations

IXmlSerializable.GetSchema()

Implémentation d'interface explicite qui obtient le schéma actuel.An explicit interface implementation that gets the current schema.

IXmlSerializable.ReadXml(XmlReader)

Implémentation d'interface explicite qui lit le nœud XML actuel.An explicit interface implementation that reads the current XML node.

IXmlSerializable.WriteXml(XmlWriter)

Implémentation d'interface explicite qui écrit un nœud XML à l'aide de writer.An explicit interface implementation that writes an XML node using writer.

Applies to