Freigeben über


XPathMessageFilter Konstruktoren

Definition

Initialisiert eine neue Instanz der XPathMessageFilter-Klasse.

Überlädt

XPathMessageFilter()

Initialisiert eine neue Instanz der XPathMessageFilter-Klasse, die mit allen wohlgeformten XML-Dokumenten übereinstimmt.

XPathMessageFilter(String)

Initialisiert eine neue Instanz der XPathMessageFilter-Klasse unter Verwendung eines XPath-Ausdrucks, um Abfragekriterien für den Filter anzugeben.

XPathMessageFilter(XmlReader)

Initialisiert eine neue Instanz der XPathMessageFilter-Klasse durch Lesen eines gestreamten XPath-Ausdrucks mit dem angegebenen XML-Reader.

XPathMessageFilter(String, XmlNamespaceManager)

Initialisiert eine neue Instanz der XPathMessageFilter-Klasse mit dem angegebenen XPath-Ausdruck und dem Namespace-Manager.

XPathMessageFilter(String, XsltContext)

Initialisiert eine neue Instanz der XPathMessageFilter-Klasse mit einem angegebenen XPath-Ausdruck und XsltContext.

XPathMessageFilter(XmlReader, XmlNamespaceManager)

Initialisiert eine neue Instanz der XPathMessageFilter-Klasse durch Lesen eines gestreamten XPath-Ausdrucks mit einem angegebenen XML-Reader und dem angegebenen Namespace-Manager.

XPathMessageFilter(XmlReader, XsltContext)

Initialisiert eine neue Instanz der XPathMessageFilter-Klasse durch Lesen eines gestreamten XPath-Ausdrucks mit einem angegebenen XML-Reader und XsltContext zur Auflösung von Namespaces, benutzerdefinierten Funktionen und Variablen.

XPathMessageFilter()

Initialisiert eine neue Instanz der XPathMessageFilter-Klasse, die mit allen wohlgeformten XML-Dokumenten übereinstimmt.

public:
 XPathMessageFilter();
public XPathMessageFilter ();
Public Sub New ()

Hinweise

Initialisiert eine neue Instanz der XPathMessageFilter-Klasse mit einem leeren XPath-Ausdruck. Ein leerer XPath-Ausdruck stimmt immer mit einem wohlgeformten XML-Dokument überein, sodass alle Objekte die Kriterien eines Filters erfüllen, der mit einem leeren XPath-Ausdruck definiert wurde.

Gilt für:

XPathMessageFilter(String)

Initialisiert eine neue Instanz der XPathMessageFilter-Klasse unter Verwendung eines XPath-Ausdrucks, um Abfragekriterien für den Filter anzugeben.

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)

Parameter

xpath
String

Eine String, die einen XPath 1.0-Ausdruck enthält.

Ausnahmen

xpath ist null

Hinweise

Verwenden Sie diesen Konstruktor, wenn keine Namespaces verwaltet werden müssen.

Dieser Konstruktor initialisiert den der XmlNamespaceManager-Eigenschaft zugeordneten Namespaces unter Verwendung des standardmäßigen XPathMessageContext, sodass der XPath-Ausdruck auf die von XPathMessageContext definierte Funktionsbibliothek zugreifen kann.

Gilt für:

XPathMessageFilter(XmlReader)

Initialisiert eine neue Instanz der XPathMessageFilter-Klasse durch Lesen eines gestreamten XPath-Ausdrucks mit dem angegebenen XML-Reader.

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)

Parameter

reader
XmlReader

Der XmlReader zum Lesen des gestreamten XPath-Ausdrucks.

Ausnahmen

reader ist null.

Hinweise

Es wird davon ausgegangen, dass der Reader am Startelement vom serialisierten XPathMessageFilter positioniert wird. Der Name des Elements wird vor dem Lesen nicht validiert. Nach dem Zurückgeben dieser Methode wird der Reader unmittelbar nach dem serialisierten XPathMessageFilter positioniert. Außerdem initialisiert der Konstruktor automatisch den Namespace-Manager, indem alle Präfixe im XPath-Ausdruck aufgelöst werden, die im Reader gebunden wurden.

Diese Methode kann auf alle mit der WriteXPathTo-Methode erstellten XML-Daten zugreifen.

Gilt für:

XPathMessageFilter(String, XmlNamespaceManager)

Initialisiert eine neue Instanz der XPathMessageFilter-Klasse mit dem angegebenen XPath-Ausdruck und dem Namespace-Manager.

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)

Parameter

xpath
String

Ein XPath 1.0-Ausdruck.

namespaces
XmlNamespaceManager

Der XmlNamespaceManager, der alle Namespacepräfixe in xpath auflöst.

Ausnahmen

xpath ist null.

Hinweise

Verwenden Sie diesen Konstruktor, wenn XPath Präfixe verwendet, die nicht in XPathMessageContext definiert sind, oder wenn Sie einen eigenen XmlNamespaceManager verwenden möchten. Eine Instanz von XPathMessageContext kann erstellt und an diese Methode übergeben werden.

Wenn es sich bei den an diese Methode übergebenen Instanzen um XsltContext-Implementierungen handelt, entspricht dies dem Aufruf des Konstruktors XPathMessageFilter.

Gilt für:

XPathMessageFilter(String, XsltContext)

Initialisiert eine neue Instanz der XPathMessageFilter-Klasse mit einem angegebenen XPath-Ausdruck und XsltContext.

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)

Parameter

xpath
String

Der XPath 1.0-Ausdruck für den Filter.

context
XsltContext

Ein XsltContext, der in xpath alle Namespacepräfixe, benutzerdefinierte Funktionen oder Variablen auflöst.

Gilt für:

XPathMessageFilter(XmlReader, XmlNamespaceManager)

Initialisiert eine neue Instanz der XPathMessageFilter-Klasse durch Lesen eines gestreamten XPath-Ausdrucks mit einem angegebenen XML-Reader und dem angegebenen Namespace-Manager.

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)

Parameter

reader
XmlReader

Der XmlReader zum Lesen des gestreamten XPath-Ausdrucks.

namespaces
XmlNamespaceManager

Ein XmlNamespaceManager, der alle Namespacepräfixe im XPath-Ausdruck von reader auflöst. Dies kann auch ein XsltContext sein, der benutzerdefinierte Funktionen oder Variablen definiert.

Ausnahmen

reader ist null.

Der reader ist nicht am Startelement positioniert.

Es sind Probleme beim Lesen des Dialektattributs oder des Namespace-URI aufgetreten, oder es wurden doppelt vorhandene Attribute gefunden.

- oder -

Ein ungültiges Dialektattribut wurde gelesen: Es handelt sich nicht um ein XPath-Attribut.

Hinweise

Verwenden Sie diesen Konstruktor, wenn Sie einen eigenen XmlReader und XmlNamespaceManager verwenden möchten, um den Filter zu definieren.

Es wird davon ausgegangen, dass der Reader am Startelement vom serialisierten XPathMessageFilter positioniert wird. Der Name des Elements wird vor dem Lesen nicht validiert. Nach dem Zurückgeben dieser Methode wird der Reader unmittelbar nach dem serialisierten XPathMessageFilter positioniert.

Gilt für:

XPathMessageFilter(XmlReader, XsltContext)

Initialisiert eine neue Instanz der XPathMessageFilter-Klasse durch Lesen eines gestreamten XPath-Ausdrucks mit einem angegebenen XML-Reader und XsltContext zur Auflösung von Namespaces, benutzerdefinierten Funktionen und Variablen.

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)

Parameter

reader
XmlReader

Der XmlReader zum Lesen des gestreamten XPath-Ausdrucks.

context
XsltContext

Ein XsltContext, der alle Namespacepräfixe, Funktionen und Variablen im XPath-Ausdruck von reader auflöst.

Ausnahmen

reader ist null.

Hinweise

Verwenden Sie diesen Konstruktor, wenn Sie einen eigenen XmlReader und XmlNamespaceManager verwenden möchten, um den Filter zu definieren.

Es wird davon ausgegangen, dass der Reader am Startelement vom serialisierten XPathMessageFilter positioniert wird. Der Name des Elements wird vor dem Lesen nicht validiert. Nach dem Zurückgeben dieser Methode wird der Reader unmittelbar nach dem serialisierten XPathMessageFilter positioniert.

Gilt für: