XPathMessageFilter Konstruktoren
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.XPathMessageFilterPublic Sub New (xpath As String)Parameter
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.XPathMessageFilterPublic Sub New (reader As XmlReader)Parameter
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.XPathMessageFilterPublic 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.XPathMessageFilterPublic 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.XPathMessageFilterPublic Sub New (reader As XmlReader, namespaces As XmlNamespaceManager)Parameter
- 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.XPathMessageFilterPublic Sub New (reader As XmlReader, context As XsltContext)Parameter
- 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.
