Teilen über


XPathDocument Konstruktoren

Definition

Initialisiert eine neue Instanz der XPathDocument-Klasse.

Überlädt

XPathDocument(Stream)

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

XPathDocument(String)

Initialisiert eine neue Instanz der XPathDocument-Klasse aus den XML-Daten in der angegebenen Datei.

XPathDocument(XmlReader)

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

XPathDocument(TextReader)

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

XPathDocument(String, XmlSpace)

Initialisiert eine neue Instanz der XPathDocument-Klasse aus den XML-Daten in der angegebenen Datei, wobei die Behandlung von Leerraum angegeben wurde.

XPathDocument(XmlReader, XmlSpace)

Initialisiert eine neue Instanz der XPathDocument-Klasse aus den XML-Daten im angegebenen XmlReader-Objekt, wobei die Behandlung von Leerraum angegeben wurde.

XPathDocument(Stream)

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

public:
 XPathDocument(System::IO::Stream ^ stream);
public XPathDocument (System.IO.Stream stream);
new System.Xml.XPath.XPathDocument : System.IO.Stream -> System.Xml.XPath.XPathDocument
Public Sub New (stream As Stream)

Parameter

stream
Stream

Das Stream-Objekt, das die XML-Daten enthält.

Ausnahmen

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

Das als Parameter übergebene Stream-Objekt ist null.

Gilt für

XPathDocument(String)

Initialisiert eine neue Instanz der XPathDocument-Klasse aus den XML-Daten in der angegebenen Datei.

public:
 XPathDocument(System::String ^ uri);
public XPathDocument (string uri);
new System.Xml.XPath.XPathDocument : string -> System.Xml.XPath.XPathDocument
Public Sub New (uri As String)

Parameter

uri
String

Der Pfad der Datei, die die XML-Daten enthält.

Ausnahmen

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

Der Dateipfadparameter ist null.

Hinweise

Verwenden Sie zum Beibehalten des Leerraums den Konstruktor, der XPathDocument ein XmlSpace Objekt als Parameter akzeptiert.

Gilt für

XPathDocument(XmlReader)

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

public:
 XPathDocument(System::Xml::XmlReader ^ reader);
public XPathDocument (System.Xml.XmlReader reader);
new System.Xml.XPath.XPathDocument : System.Xml.XmlReader -> System.Xml.XPath.XPathDocument
Public Sub New (reader As XmlReader)

Parameter

reader
XmlReader

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

Ausnahmen

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

Das als Parameter übergebene XmlReader-Objekt ist null.

Hinweise

Ein XmlReader Objekt kann verwendet werden, um ein gesamtes XML-Dokument oder einen Teil eines XML-Dokuments in ein XML-Dokument XPathDocumentzu laden. Um einen Teil eines XML-Dokuments in ein XPathDocumentXML-Dokument zu laden, positionieren Sie das XmlReader Objekt auf dem oberen XML-Knoten, um Daten zu laden. Wenn Sie eine XPathDocument mithilfe des XPathDocument Konstruktors erstellen, werden Daten aus dem aktuellen oberen Knoten über alle gleichgeordneten Knoten geladen. Danach wird die XmlReader Position im äußeren Bereich des oberen XML-Knotens positioniert. Alternativ können Sie die ReadSubtree Methode verwenden, um das XPathDocument Element in ein bestimmtes Element im XML-Dokument zu laden.

Im Folgenden sind wichtige Hinweise zu berücksichtigen, wenn Sie den XPathDocument Konstruktor verwenden.

  • Ein XmlReader Objekt mit den entsprechenden zugeordneten XmlResolver Objekteinstellungen kann verwendet werden, um Entitäten oder andere Verweise in XML-Daten aufzulösen.

  • Wenn das XmlReader Objekt auf einem Blattknoten positioniert ist, der für die Stammebene eines Dokuments nicht gültig ist – z. B. ein Leerzeichen oder Attributknoten – wird das XmlReader Objekt weiterhin gelesen, bis es auf einem Knoten positioniert ist, der für den Stamm verwendet werden kann. Der XPathDocument Anfang des Ladens an diesem Punkt.

  • Verwenden Sie zum Beibehalten des Leerraums den Konstruktor, der XPathDocument ein XmlSpace Objekt als Parameter akzeptiert.

Gilt für

XPathDocument(TextReader)

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

public:
 XPathDocument(System::IO::TextReader ^ textReader);
public:
 XPathDocument(System::IO::TextReader ^ reader);
public XPathDocument (System.IO.TextReader textReader);
public XPathDocument (System.IO.TextReader reader);
new System.Xml.XPath.XPathDocument : System.IO.TextReader -> System.Xml.XPath.XPathDocument
new System.Xml.XPath.XPathDocument : System.IO.TextReader -> System.Xml.XPath.XPathDocument
Public Sub New (textReader As TextReader)
Public Sub New (reader As TextReader)

Parameter

textReaderreader
TextReader

Das TextReader-Objekt, das die XML-Daten enthält.

Ausnahmen

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

Das als Parameter übergebene TextReader-Objekt ist null.

Hinweise

Nachdem das TextReader Objekt zum Laden von XML-Daten verwendet wurde, wird der Cursor des TextReader Objekts am Ende der Daten positioniert. Das TextReader Objekt muss zurückgesetzt werden, um die Daten erneut zu lesen.

Gilt für

XPathDocument(String, XmlSpace)

Initialisiert eine neue Instanz der XPathDocument-Klasse aus den XML-Daten in der angegebenen Datei, wobei die Behandlung von Leerraum angegeben wurde.

public:
 XPathDocument(System::String ^ uri, System::Xml::XmlSpace space);
public XPathDocument (string uri, System.Xml.XmlSpace space);
new System.Xml.XPath.XPathDocument : string * System.Xml.XmlSpace -> System.Xml.XPath.XPathDocument
Public Sub New (uri As String, space As XmlSpace)

Parameter

uri
String

Der Pfad der Datei, die die XML-Daten enthält.

space
XmlSpace

Ein XmlSpace-Objekt.

Ausnahmen

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

Der Dateipfadparameter oder XmlSpace-Objektparameter ist null.

Hinweise

  • Das XmlSpace als Parameter übergebene Objekt gibt an, ob Leerzeichen beibehalten werden sollen. Default behält nur einen erheblichen Leerraum bei; Preserve behält den gesamten Leerraum bei. Standardmäßig ist das XmlSpace Objekt auf Default.

  • Die Funktionalität des XPathDocument Konstruktors ist identisch mit dem XPathDocument des Konstruktors, mit Ausnahme der beschriebenen Optionen für die Verarbeitung von Leerzeichen.

Siehe auch

Gilt für

XPathDocument(XmlReader, XmlSpace)

Initialisiert eine neue Instanz der XPathDocument-Klasse aus den XML-Daten im angegebenen XmlReader-Objekt, wobei die Behandlung von Leerraum angegeben wurde.

public:
 XPathDocument(System::Xml::XmlReader ^ reader, System::Xml::XmlSpace space);
public XPathDocument (System.Xml.XmlReader reader, System.Xml.XmlSpace space);
new System.Xml.XPath.XPathDocument : System.Xml.XmlReader * System.Xml.XmlSpace -> System.Xml.XPath.XPathDocument
Public Sub New (reader As XmlReader, space As XmlSpace)

Parameter

reader
XmlReader

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

space
XmlSpace

Ein XmlSpace-Objekt.

Ausnahmen

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

Der XmlReader-Objektparameter oder der XmlSpace-Objektparameter ist null.

Hinweise

  • Das XmlSpace als Parameter übergebene Objekt gibt an, ob Leerzeichen beibehalten werden sollen. Default behält nur einen erheblichen Leerraum bei; Preserve behält den gesamten Leerraum bei. Standardmäßig ist das XmlSpace Objekt auf Default.

  • Die Funktionalität des XPathDocument Konstruktors ist identisch mit dem XPathDocument des Konstruktors, mit Ausnahme der beschriebenen Optionen für die Verarbeitung von Leerzeichen.

Siehe auch

Gilt für