XPathMessageFilter Costruttori
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Inizializza una nuova istanza della classe XPathMessageFilter.
Overload
XPathMessageFilter() |
Inizializza una nuova istanza della classe XPathMessageFilter, corrispondente a documenti XML in formato corretto. |
XPathMessageFilter(String) |
Inizializza una nuova istanza della classe XPathMessageFilter utilizzando un'espressione XPath per specificare i criteri di query per il filtro. |
XPathMessageFilter(XmlReader) |
Inizializza una nuova istanza della classe XPathMessageFilter tramite la lettura di un'espressione XPath inviata come flusso con il lettore XML specificato. |
XPathMessageFilter(String, XmlNamespaceManager) |
Inizializza una nuova istanza della classe XPathMessageFilter utilizzando l'espressione XPath e il gestore dello spazio dei nomi specificati. |
XPathMessageFilter(String, XsltContext) |
Inizializza una nuova istanza della classe XPathMessageFilter utilizzando un'espressione XPath e un oggetto XsltContext specificati. |
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. |
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. |
XPathMessageFilter()
Inizializza una nuova istanza della classe XPathMessageFilter, corrispondente a documenti XML in formato corretto.
public:
XPathMessageFilter();
public XPathMessageFilter ();
Public Sub New ()
Commenti
Inizializza una nuova istanza della classe XPathMessageFilter con un'espressione XPath vuota. Un'espressione XPath vuota corrisponde sempre a un documento XML in formato corretto, pertanto tutti gli oggetti soddisfanno i criteri di un filtro definito da un'espressione XPath vuota.
Si applica a
XPathMessageFilter(String)
Inizializza una nuova istanza della classe XPathMessageFilter utilizzando un'espressione XPath per specificare i criteri di query per il filtro.
public:
XPathMessageFilter(System::String ^ xpath);
public XPathMessageFilter (string xpath);
new System.ServiceModel.Dispatcher.XPathMessageFilter : string -> System.ServiceModel.Dispatcher.XPathMessageFilter
Public Sub New (xpath As String)
Parametri
Eccezioni
xpath
è null
.
Commenti
Utilizzare questo costruttore quando non vi sono spazi dei nomi da gestire.
Questo costruttore inizializza l'oggetto XmlNamespaceManager assegnato alla proprietà Namespaces utilizzando l'elemento XPathMessageContext predefinito, pertanto l'espressione XPath ha accesso alla libreria di funzioni definita da XPathMessageContext.
Si applica a
XPathMessageFilter(XmlReader)
Inizializza una nuova istanza della classe XPathMessageFilter tramite la lettura di un'espressione XPath inviata come flusso con il lettore XML specificato.
public:
XPathMessageFilter(System::Xml::XmlReader ^ reader);
public XPathMessageFilter (System.Xml.XmlReader reader);
new System.ServiceModel.Dispatcher.XPathMessageFilter : System.Xml.XmlReader -> System.ServiceModel.Dispatcher.XPathMessageFilter
Public Sub New (reader As XmlReader)
Parametri
Eccezioni
reader
è null
.
Commenti
Si presuppone che il lettore sia posizionato in corrispondenza dell'elemento iniziale del serializzatore XPathMessageFilter
. Il nome dell'elemento non viene convalidato prima della lettura. Quando questo metodo termina, il lettore è posizionato immediatamente dopo l'oggetto XPathMessageFilter
serializzato. Il costruttore inoltre inizializza automaticamente il gestore dello spazio dei nomi risolvendo tutti i prefissi contenuti nell'espressione XPath così come sono stati associati nel lettore.
Questo metodo può accedere a qualsiasi elemento XML che è possibile creare tramite il metodo WriteXPathTo.
Si applica a
XPathMessageFilter(String, XmlNamespaceManager)
Inizializza una nuova istanza della classe XPathMessageFilter utilizzando l'espressione XPath e il gestore dello spazio dei nomi specificati.
public:
XPathMessageFilter(System::String ^ xpath, System::Xml::XmlNamespaceManager ^ namespaces);
public XPathMessageFilter (string xpath, System.Xml.XmlNamespaceManager namespaces);
new System.ServiceModel.Dispatcher.XPathMessageFilter : string * System.Xml.XmlNamespaceManager -> System.ServiceModel.Dispatcher.XPathMessageFilter
Public Sub New (xpath As String, namespaces As XmlNamespaceManager)
Parametri
- xpath
- String
Espressione XPath 1.0.
- namespaces
- XmlNamespaceManager
Oggetto XmlNamespaceManager che risolve i prefissi degli spazi dei nomi in xpath
.
Eccezioni
xpath
è null
.
Commenti
Utilizzare questo costruttore quando in XPath vengono utilizzati prefissi non definiti in XPathMessageContext o quando si desidera utilizzare un oggetto XmlNamespaceManager personalizzato. È possibile creare un'istanza di XPathMessageContext e passarla a questo metodo.
Se le istanze fornite a questo metodo sono implementazioni di XsltContext, è equivalente alla chiamata al costruttore XPathMessageFilter.
Si applica a
XPathMessageFilter(String, XsltContext)
Inizializza una nuova istanza della classe XPathMessageFilter utilizzando un'espressione XPath e un oggetto XsltContext specificati.
public:
XPathMessageFilter(System::String ^ xpath, System::Xml::Xsl::XsltContext ^ context);
public XPathMessageFilter (string xpath, System.Xml.Xsl.XsltContext context);
new System.ServiceModel.Dispatcher.XPathMessageFilter : string * System.Xml.Xsl.XsltContext -> System.ServiceModel.Dispatcher.XPathMessageFilter
Public Sub New (xpath As String, context As XsltContext)
Parametri
- xpath
- String
Espressione di XPath 1.0 per il filtro.
- context
- XsltContext
XsltContext che risolve i prefissi di spazi dei nomi, funzioni o variabili personalizzate in xpath
.
Si applica a
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.
public:
XPathMessageFilter(System::Xml::XmlReader ^ reader, System::Xml::XmlNamespaceManager ^ namespaces);
public XPathMessageFilter (System.Xml.XmlReader reader, System.Xml.XmlNamespaceManager namespaces);
new System.ServiceModel.Dispatcher.XPathMessageFilter : System.Xml.XmlReader * System.Xml.XmlNamespaceManager -> System.ServiceModel.Dispatcher.XPathMessageFilter
Public Sub New (reader As XmlReader, namespaces As XmlNamespaceManager)
Parametri
- namespaces
- XmlNamespaceManager
Oggetto XmlNamespaceManager utilizzato per la risoluzione dei prefissi degli spazi dei nomi contenuti nell'espressione XPath da reader
. Può trattarsi anche di un oggetto XsltContext che definisce funzioni o variabili personalizzate.
Eccezioni
reader
è null
.
L'oggetto reader
non è posizionato in corrispondenza dell'elemento iniziale.
Si sono verificati problemi durante la lettura dell'attributo del dialetto o dell'URI dello spazio dei nomi oppure sono stati trovati attributi duplicati.
-oppure-
È stato letto un attributo del sottolinguaggio non valido, ovvero non nel formato di XPath.
Commenti
Utilizzare questo costruttore quando si desidera utilizzare oggetti XmlReader e XmlNamespaceManager personalizzati per definire il filtro.
Si presuppone che il lettore sia posizionato in corrispondenza dell'elemento iniziale del serializzatore XPathMessageFilter
. Il nome dell'elemento non viene convalidato prima della lettura. Quando questo metodo termina, il lettore è posizionato immediatamente dopo l'oggetto XPathMessageFilter
serializzato.
Si applica a
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.
public:
XPathMessageFilter(System::Xml::XmlReader ^ reader, System::Xml::Xsl::XsltContext ^ context);
public XPathMessageFilter (System.Xml.XmlReader reader, System.Xml.Xsl.XsltContext context);
new System.ServiceModel.Dispatcher.XPathMessageFilter : System.Xml.XmlReader * System.Xml.Xsl.XsltContext -> System.ServiceModel.Dispatcher.XPathMessageFilter
Public Sub New (reader As XmlReader, context As XsltContext)
Parametri
- context
- XsltContext
XsltContext che risolve prefissi degli spazi dei nomi, funzioni e variabili nell'espressione XPath da reader
.
Eccezioni
reader
è null
.
Commenti
Utilizzare questo costruttore quando si desidera utilizzare oggetti XmlReader e XmlNamespaceManager personalizzati per definire il filtro.
Si presuppone che il lettore sia posizionato in corrispondenza dell'elemento iniziale del serializzatore XPathMessageFilter
. Il nome dell'elemento non viene convalidato prima della lettura. Quando questo metodo termina, il lettore è posizionato immediatamente dopo l'oggetto XPathMessageFilter
serializzato.