XPathDocument 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 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.XPathDocumentPublic Sub New (stream As Stream)Parameter
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.XPathDocumentPublic 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.XPathDocumentPublic Sub New (reader As XmlReader)Parameter
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.XPathDocumentnew System.Xml.XPath.XPathDocument : System.IO.TextReader -> System.Xml.XPath.XPathDocumentPublic 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.XPathDocumentPublic Sub New (uri As String, space As XmlSpace)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 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.XPathDocumentPublic Sub New (reader As XmlReader, space As XmlSpace)Parameter
Ausnahmen
In den XML-Daten wurde ein Fehler gefunden. Das XPathDocument bleibt leer.
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.