XPathMessageFilter XPathMessageFilter XPathMessageFilter XPathMessageFilter Class

Definizione

Rappresenta una query su un documento XML definito da un'espressione di 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
Ereditarietà
XPathMessageFilterXPathMessageFilterXPathMessageFilterXPathMessageFilter
Implementazioni

Commenti

XPathMessageFilter utilizza un'espressione XPath per determinare se un documento XML contiene elementi specifici, attributi, testo o altri costrutti sintattici XML.An XPathMessageFilter uses an XPath expression to determine whether an XML document contains specific elements, attributes, text, or other XML syntactic constructs. In genere, un'applicazione utilizza XPathMessageFilter in un endpoint per eseguire una query sul contenuto di un messaggio SOAP e quindi agisce appropriatamente in base ai risultati della query.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 processo di accodamento, ad esempio, può utilizzare una query XPath per controllare l'elemento prioritario di un'intestazione nota per decidere se spostare un messaggio all'inizio della coda.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.

XPath (XML Path Language) è un linguaggio per l'indirizzamento di parti di un documento XML.The XML Path Language (XPath) provides a language for addressing parts of an XML document. Il costrutto sintattico primario in XPath è un'espressione che definisce come attraversare la struttura logica di un documento e di un indirizzo XML o come identificare un tipo di dati 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. Specificamente le implementazioni XPath valutano un'espressione a fronte della struttura di un documento XML in modo da ottenere uno dei quattro tipi di dati XPath di base: stringhe, numeri, valori booleani e set di nodi.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. Supportano inoltre funzioni che convertono un tipo di dati XPath in un tipo stringa, numero o valore booleano.They also support functions that convert an XPath data type to a string, number, or Boolean data type. Se per un metodo è previsto uno di questi tre tipi di dati, il risultato della valutazione dell'espressione verrà convertito implicitamente.If a method expects one of these three data types, the result of the expression evaluation is implicitly converted. Si noti che questi tre tipi di dati non possono essere convertiti in un tipo impostato dal nodo.Note that these three data types cannot be converted to a node-set type. Il linguaggio del percorso XML è completamente descritto nella specifica W3C XML Path language 1,0.The XML Path language is fully described in the W3C XML Path Language 1.0 specification.

Nelle espressioni XPath i numeri sono espressi come valori a 64 bit a precisione doppia,Numbers in XPath expressions are expressed as double-precision 64-bit values. pertanto le espressioni XPath che comportano la verifica di numeri con molte cifre significative possono restituire risultati non corretti a causa di problemi correlati alla precisione della virgola mobile.Therefore XPath expressions that involve testing numbers with many significant digits can return incorrect results due to floating point precision issues. Per ulteriori informazioni, vedere la sezione 3,5 del linguaggio XPath (XML Path Language) 1,0.For more information, see XML Path Language (XPath) Version 1.0, section 3.5.

Costruttori

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

Inizializza una nuova istanza della classe XPathMessageFilter, corrispondente a documenti XML in formato corretto.Initializes a new instance of the XPathMessageFilter class that matches all well-formed XML documents.

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

Inizializza una nuova istanza della classe XPathMessageFilter utilizzando un'espressione XPath per specificare i criteri di query per il 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)

Inizializza una nuova istanza della classe XPathMessageFilter utilizzando l'espressione XPath e il gestore dello spazio dei nomi specificati.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)

Inizializza una nuova istanza della classe XPathMessageFilter utilizzando un'espressione XPath e un oggetto XsltContext specificati.Initializes a new instance of the XPathMessageFilter class using a specified XPath expression and XsltContext.

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

Inizializza una nuova istanza della classe XPathMessageFilter tramite la lettura di un'espressione XPath inviata come flusso con il lettore XML specificato.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)

Inizializza una nuova istanza della classe XPathMessageFilter leggendo all'interno di un'espressione XPath trasmessa con il lettore XML specificato e utilizzando il gestore dello spazio dei nomi indicato.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)

Inizializza una nuova istanza della classe XPathMessageFilter tramite la lettura di un'espressione XPath inviata come flusso con il lettore XML specificato e l'utilizzo dell'oggetto XsltContext per risolvere spazi dei nomi, funzioni personalizzate e variabili.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.

Proprietà

Namespaces Namespaces Namespaces Namespaces

Ottiene il gestore che risolve i prefissi degli spazi dei nomi nell'espressione XPath che definisce il filtro.Gets the manager that resolves namespace prefixes in the XPath expression that defines the filter.

NodeQuota NodeQuota NodeQuota NodeQuota

Ottiene o imposta il numero massimo di nodi da esaminare durante la valutazione del filtro.Gets or sets the maximum number of nodes that should be looked at during filter evaluation.

XPath XPath XPath XPath

Ottiene l'espressione XPath che definisce i criteri di query per il filtro.Gets the XPath expression that defines the query criteria for the filter.

Metodi

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

Crea un oggetto XPathMessageFilterTable<TFilterData> a cui è associato un tipo di dati specificato.Creates an XPathMessageFilterTable<TFilterData> that has a specified type of data associated with it.

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

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

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

Funge da funzione hash predefinita.Serves as the default hash function.

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

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

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

Verifica se un messaggio specificato soddisfa i criteri del filtro XPath.Tests whether a specified message satisfies the criteria of the XPath filter. Non è consentito utilizzare questa forma per accedere al corpo del messaggio.This form is not allowed to access the body of the message.

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

Determina se un messaggio memorizzato nel buffer soddisfa i criteri di query del filtro XPath.Determines whether a buffered message satisfies the query criteria of the XPath filter.

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

Determina se il documento XML fornito dal navigatore XPath ottimizzato specificato soddisfa i criteri di query del filtro 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)

Valuta il filtro in base al navigatore XPath specificato.Evaluates the filter over the specified XPath navigator.

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

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

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

Ottiene lo schema per il documento XML corrente.Gets the schema for the current XML document.

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

Legge il nodo XML corrente.Reads the current XML node.

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

Scrive un nodo utilizzando writer.Writes a node using writer.

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

Inizializza l'istanza corrente di XPathMessageFilter con un elemento XPath ottenuto da un lettore XML specificato utilizzando un gestore dello spazio dei nomi specificato.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)

Ottiene il tipo di XML Schema utilizzato per serializzare il filtro XPath.Gets the type of XML schema used to serialize the XPath filter.

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

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

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

Comprime il filtro XPath che rilascia tutta la memoria inutilizzata.Compacts the XPath filter, which releases all unused memory.

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

Serializza il filtro XPath in un oggetto 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)

Scrive l'elemento XPath XML con un writer XML specificato.Writes the XML XPath element with a specified XML writer.

Implementazioni dell'interfaccia esplicita

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

Implementazione esplicita dell'interfaccia che ottiene lo schema corrente.An explicit interface implementation that gets the current schema.

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

Implementazione esplicita dell'interfaccia che legge il nodo XML corrente.An explicit interface implementation that reads the current XML node.

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

Implementazione esplicita dell'interfaccia che scrive un nodo XML utilizzando writer.An explicit interface implementation that writes an XML node using writer.

Si applica a