Freigeben über

XPathDocument-Konstruktor (XmlReader)

  • Artikel

Initialisiert eine neue Instanz der XPathDocument-Klasse aus den XML-Daten im angegebenen XmlReader-Objekt.

Namespace: System.Xml.XPath
Assembly: System.Xml (in system.xml.dll)

Syntax

'Declaration
Public Sub New ( _
    reader As XmlReader _
)
'Usage
Dim reader As XmlReader

Dim instance As New XPathDocument(reader)

public XPathDocument (
    XmlReader reader
)

public:
XPathDocument (
    XmlReader^ reader
)

public XPathDocument (
    XmlReader reader
)

public function XPathDocument (
    reader : XmlReader
)

Parameter

  • reader
    Das XmlReader-Objekt, das die XML-Daten enthält.

Ausnahmen

Ausnahmetyp Bedingung

XmlException

In den XML-Daten wurde ein Fehler gefunden. Das XPathDocument bleibt leer.

ArgumentNullException

Das als Parameter übergebene XmlReader-Objekt ist NULL (Nothing in Visual Basic).

Hinweise

Ein XmlReader-Objekt kann verwendet werden, um ein vollständiges XML-Dokument oder ein Teil eines XML-Dokuments in ein XPathDocument zu laden. Um einen Teil eines XML-Dokuments in ein XPathDocument zu laden, positionieren Sie das XmlReader-Objekt auf dem obersten XML-Knoten, aus dem Daten geladen werden sollen. Wenn Sie ein XPathDocument mithilfe des XPathDocument-Konstruktors erstellen, werden die Daten aus dem aktuellen obersten Knoten geladen, bis das Endtag des Knotens erreicht ist. Die Daten aller untergeordneten Knoten sind ebenfalls enthalten.

Im Folgenden finden Sie wichtige Hinweise zum Verwenden des XPathDocument-Konstruktors.

  • Ein XmlReader-Objekt mit entsprechenden zugehörigen XmlResolver-Objekteinstellungen kann zum Auflösen von Entitäten und anderen Verweisen in den XML-Daten verwendet werden.

  • Wenn das XmlReader-Objekt auf einem Endknoten platziert ist, der für die Stammebene eines Dokuments ungültig ist, z. B. ein Leerraum- oder Attributknoten, liest das XmlReader-Objekt weiter, bis es sich auf einem Knoten befindet, der für den Stamm verwendet werden kann. Das XPathDocument beginnt an dieser Stelle mit dem Laden.

  • Um Leerraum beizubehalten, verwenden Sie den XPathDocument-Konstruktor, der ein XmlSpace-Objekt als Parameter akzeptiert.

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

XPathDocument-Klasse
XPathDocument-Member
System.Xml.XPath-Namespace