XPathMessageFilter XPathMessageFilter XPathMessageFilter XPathMessageFilter Class

Definición

Representa una consulta en un documento XML definida por una expresión 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
Herencia
XPathMessageFilterXPathMessageFilterXPathMessageFilterXPathMessageFilter
Implementaciones

Comentarios

Un XPathMessageFilter utiliza una expresión XPath para determinar si un documento XML contiene elementos concretos, atributos, texto u otras construcciones sintácticas de XML.An XPathMessageFilter uses an XPath expression to determine whether an XML document contains specific elements, attributes, text, or other XML syntactic constructs. Normalmente, una aplicación usa un XPathMessageFilter en un extremo para consultar el contenido de un mensaje SOAP y, a continuación, realiza las acciones apropiadas en función de los resultados de esa consulta.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. Un proceso de cola, por ejemplo, puede utilizar una consulta de XPath para comprobar el elemento de prioridad de un encabezado conocido para decidir si poner un mensaje al principio de la cola.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) proporciona un lenguaje para direccionar partes de un documento XML.The XML Path Language (XPath) provides a language for addressing parts of an XML document. La construcción sintáctica primaria en XPath es una expresión que define cómo atravesar la estructura lógica de un documento y una dirección XML o identificar un tipo de datos de 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. Específicamente, las implementaciones de XPath evalúan una expresión en comparación con la estructura de un documento XML para producir uno de los cuatro tipos básicos de datos de XPath: cadenas, números, booleanos y conjuntos de nodos.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. También admiten funciones que convierten un tipo de datos de XPath en un tipo de datos de cadena, número o booleano.They also support functions that convert an XPath data type to a string, number, or Boolean data type. Si un método espera uno de estos tres tipos de datos, el resultado de la evaluación de expresión se convierte implícitamente.If a method expects one of these three data types, the result of the expression evaluation is implicitly converted. Observe que estos tres tipos de datos no se pueden convertir en un tipo de conjunto de nodos.Note that these three data types cannot be converted to a node-set type. El lenguaje de rutas XML está totalmente descrito en la especificación W3C XML Path language 1,0.The XML Path language is fully described in the W3C XML Path Language 1.0 specification.

Los números en las expresiones XPath se expresan como valores de 64 bits de precisión doble.Numbers in XPath expressions are expressed as double-precision 64-bit values. Por consiguiente, las expresiones XPath que implican números de prueba con muchos dígitos significativos pueden devolver resultados incorrectos debido a los problemas de precisión de coma flotante.Therefore XPath expressions that involve testing numbers with many significant digits can return incorrect results due to floating point precision issues. Para obtener más información, consulte XML Path Language (XPath) Version 1,0, sección 3,5.For more information, see XML Path Language (XPath) Version 1.0, section 3.5.

Constructores

XPathMessageFilter() XPathMessageFilter() XPathMessageFilter() XPathMessageFilter()

Inicializa una nueva instancia de la clase XPathMessageFilter que coincide con todos los documentos XML correctos.Initializes a new instance of the XPathMessageFilter class that matches all well-formed XML documents.

XPathMessageFilter(String) XPathMessageFilter(String) XPathMessageFilter(String) XPathMessageFilter(String)

Inicializa una nueva instancia de la clase XPathMessageFilter utilizando una expresión XPath para especificar los criterios de consulta para el filtro.Initializes a new instance of the XPathMessageFilter class using an XPath expression to specify query criteria for the filter.

XPathMessageFilter(String, XmlNamespaceManager) XPathMessageFilter(String, XmlNamespaceManager) XPathMessageFilter(String, XmlNamespaceManager) XPathMessageFilter(String, XmlNamespaceManager)

Inicializa una nueva instancia de la clase XPathMessageFilter utilizando el gestor especificado de expresión y espacio de nombres de XPath.Initializes a new instance of the XPathMessageFilter class using the specified XPath expression and namespace manager.

XPathMessageFilter(String, XsltContext) XPathMessageFilter(String, XsltContext) XPathMessageFilter(String, XsltContext) XPathMessageFilter(String, XsltContext)

Inicializa una nueva instancia de la clase XPathMessageFilter utilizando una expresión XPath especificada y XsltContext.Initializes a new instance of the XPathMessageFilter class using a specified XPath expression and XsltContext.

XPathMessageFilter(XmlReader) XPathMessageFilter(XmlReader) XPathMessageFilter(XmlReader) XPathMessageFilter(XmlReader)

Inicializa una nueva instancia de la clase XPathMessageFilter leyendo un XPath transmitido con el lector XML especificado.Initializes a new instance of the XPathMessageFilter class by reading a streamed XPath with the specified XML reader.

XPathMessageFilter(XmlReader, XmlNamespaceManager) XPathMessageFilter(XmlReader, XmlNamespaceManager) XPathMessageFilter(XmlReader, XmlNamespaceManager) XPathMessageFilter(XmlReader, XmlNamespaceManager)

Inicializa una nueva instancia de la clase XPathMessageFilter leyendo en un XPath transmitido con un lector XML especificado y utilizando el gestor de espacio de nombres especificado.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) XPathMessageFilter(XmlReader, XsltContext) XPathMessageFilter(XmlReader, XsltContext) XPathMessageFilter(XmlReader, XsltContext)

Inicializa una nueva instancia de la clase XPathMessageFilter leyendo un XPath transmitido con un lector XML especificado y utilizando XsltContext para resolver espacios de nombres, funciones personalizadas y 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.

Propiedades

Namespaces Namespaces Namespaces Namespaces

Obtiene el administrador que resuelve los prefijos de espacio de nombres en la expresión XPath que define el filtro.Gets the manager that resolves namespace prefixes in the XPath expression that defines the filter.

NodeQuota NodeQuota NodeQuota NodeQuota

Obtiene o establece el número máximo de nodos que se deberían examinar durante la evaluación del filtro.Gets or sets the maximum number of nodes that should be looked at during filter evaluation.

XPath XPath XPath XPath

Obtiene la expresión XPath que define los criterios de búsqueda para el filtro.Gets the XPath expression that defines the query criteria for the filter.

Métodos

CreateFilterTable<FilterData>() CreateFilterTable<FilterData>() CreateFilterTable<FilterData>() CreateFilterTable<FilterData>()

Crea un XPathMessageFilterTable<TFilterData> que tiene un tipo especificado de datos asociado a él.Creates an XPathMessageFilterTable<TFilterData> that has a specified type of data associated with it.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
Match(Message) Match(Message) Match(Message) Match(Message)

Prueba si un mensaje especificado satisface los criterios del filtro de XPath.Tests whether a specified message satisfies the criteria of the XPath filter. Este formulario no puede tener acceso al cuerpo del mensaje.This form is not allowed to access the body of the message.

Match(MessageBuffer) Match(MessageBuffer) Match(MessageBuffer) Match(MessageBuffer)

Determina si un mensaje almacenado en búfer satisface los criterios de búsqueda del filtro de XPath.Determines whether a buffered message satisfies the query criteria of the XPath filter.

Match(SeekableXPathNavigator) Match(SeekableXPathNavigator) Match(SeekableXPathNavigator) Match(SeekableXPathNavigator)

Determina si el documento XML proporcionado por el explorador XPath optimizado especificado satisface los criterios de búsqueda del filtro de XPath.Determines whether the XML document provided by the specified optimized XPath navigator satisfies the query criteria of the XPath filter.

Match(XPathNavigator) Match(XPathNavigator) Match(XPathNavigator) Match(XPathNavigator)

Evalúa el filtro sobre el explorador XPath especificado.Evaluates the filter over the specified XPath navigator.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
OnGetSchema() OnGetSchema() OnGetSchema() OnGetSchema()

Obtiene el esquema del documento XML actual.Gets the schema for the current XML document.

OnReadXml(XmlReader) OnReadXml(XmlReader) OnReadXml(XmlReader) OnReadXml(XmlReader)

Lee el nodo XML actual.Reads the current XML node.

OnWriteXml(XmlWriter) OnWriteXml(XmlWriter) OnWriteXml(XmlWriter) OnWriteXml(XmlWriter)

Escribe un nodo mediante writer.Writes a node using writer.

ReadXPath(XmlReader, XmlNamespaceManager) ReadXPath(XmlReader, XmlNamespaceManager) ReadXPath(XmlReader, XmlNamespaceManager) ReadXPath(XmlReader, XmlNamespaceManager)

Inicializa la instancia actual de XPathMessageFilter con un XPath obtenido a partir de un lector XML especificado utilizando un administrador de espacios de nombres determinado.Initializes the current instance of the XPathMessageFilter with an XPath obtained from a specified XML reader using a specified namespace manager.

StaticGetSchema(XmlSchemaSet) StaticGetSchema(XmlSchemaSet) StaticGetSchema(XmlSchemaSet) StaticGetSchema(XmlSchemaSet)

Obtiene el tipo de esquema XML utilizado para serializar el filtro de XPath.Gets the type of XML schema used to serialize the XPath filter.

ToString() ToString() ToString() ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)
TrimToSize() TrimToSize() TrimToSize() TrimToSize()

Compacta el filtro de XPath, que libera toda la memoria no utilizada.Compacts the XPath filter, which releases all unused memory.

WriteXPath(XmlWriter, IXmlNamespaceResolver) WriteXPath(XmlWriter, IXmlNamespaceResolver) WriteXPath(XmlWriter, IXmlNamespaceResolver) WriteXPath(XmlWriter, IXmlNamespaceResolver)

Serializa el filtro de XPath en XmlWriter.Serializes the XPath filter to an XmlWriter.

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

Escribe el elemento XPath de XML con un sistema de escritura XML especificado.Writes the XML XPath element with a specified XML writer.

Implementaciones de interfaz explícitas

IXmlSerializable.GetSchema() IXmlSerializable.GetSchema() IXmlSerializable.GetSchema() IXmlSerializable.GetSchema()

Una implementación de interfaz explícita que obtiene el esquema actual.An explicit interface implementation that gets the current schema.

IXmlSerializable.ReadXml(XmlReader) IXmlSerializable.ReadXml(XmlReader) IXmlSerializable.ReadXml(XmlReader) IXmlSerializable.ReadXml(XmlReader)

Implementación de interfaz explícita que lee el nodo XML actual.An explicit interface implementation that reads the current XML node.

IXmlSerializable.WriteXml(XmlWriter) IXmlSerializable.WriteXml(XmlWriter) IXmlSerializable.WriteXml(XmlWriter) IXmlSerializable.WriteXml(XmlWriter)

Implementación de interfaz explícita que escribe un nodo XML mediante writer.An explicit interface implementation that writes an XML node using writer.

Se aplica a