XPathMessageFilter Costruttori

Definizione

Spazio dei nomi:

System.ServiceModel.Dispatcher

Assembly:

System.ServiceModel.dll

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.

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

xpath

String

String contenente un'espressione di XPath 1.0.

Eccezioni

ArgumentNullException

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.

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

reader

XmlReader

XmlReader per leggere l'espressione XPath trasmessa.

Eccezioni

ArgumentNullException

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.

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

ArgumentNullException

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.

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.

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

reader

XmlReader

XmlReader per leggere l'espressione XPath trasmessa.

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

ArgumentNullException

reader è null.

ArgumentException

L'oggetto reader non è posizionato in corrispondenza dell'elemento iniziale.

InvalidOperationException

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.

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

reader

XmlReader

XmlReader per leggere l'espressione XPath trasmessa.

context

XsltContext

XsltContext che risolve prefissi degli spazi dei nomi, funzioni e variabili nell'espressione XPath da reader.

Eccezioni

ArgumentNullException

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.