XPathDocument Konstruktoren

Definition

Namespace:: System.Xml.XPath

Assemblys:: netstandard.dll, System.Xml.XPath.dll

Assembly:: System.Xml.XPath.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

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

Name	Beschreibung
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, die im angegebenen XmlReader Objekt enthalten sind.
XPathDocument(TextReader)	Initialisiert eine neue Instanz der XPathDocument Klasse aus den XML-Daten, die im angegebenen TextReader Objekt enthalten sind.
XPathDocument(String, XmlSpace)	Initialisiert eine neue Instanz der XPathDocument Klasse aus den XML-Daten in der Datei, die mit der angegebenen Leerraumbehandlung angegeben ist.
XPathDocument(XmlReader, XmlSpace)	Initialisiert eine neue Instanz der XPathDocument Klasse aus den XML-Daten, die im angegebenen XmlReader Objekt mit der angegebenen Leerraumbehandlung enthalten sind.

XPathDocument(Stream)

Quelle:: XPathDocument.cs

Quelle:: XPathDocument.cs

Quelle:: XPathDocument.cs

Quelle:: XPathDocument.cs

Quelle:: XPathDocument.cs

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

XmlException

Fehler in den XML-Daten. Die XPathDocument bleibt leer.

ArgumentNullException

Das Stream als Parameter übergebene Objekt ist null.

Gilt für:

XPathDocument(String)

Quelle:: XPathDocument.cs

Quelle:: XPathDocument.cs

Quelle:: XPathDocument.cs

Quelle:: XPathDocument.cs

Quelle:: XPathDocument.cs

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

XmlException

Fehler in den XML-Daten. Die XPathDocument bleibt leer.

ArgumentNullException

Der Dateipfadparameter ist null.

Hinweise

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

Gilt für:

XPathDocument(XmlReader)

Quelle:: XPathDocument.cs

Quelle:: XPathDocument.cs

Quelle:: XPathDocument.cs

Quelle:: XPathDocument.cs

Quelle:: XPathDocument.cs

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

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

XmlException

Fehler in den XML-Daten. Die XPathDocument bleibt leer.

ArgumentNullException

Das XmlReader als Parameter übergebene Objekt ist null.

Hinweise

Ein XmlReader Objekt kann verwendet werden, um ein gesamtes XML-Dokument oder einen Teil eines XML-Dokuments in ein XPathDocument. Wenn Sie einen Teil eines XML-Dokuments in ein XPathDocumentXML-Dokument laden möchten, positionieren Sie das XmlReader Objekt auf dem oberen XML-Knoten, aus dem Daten geladen werden sollen. Wenn Sie eine XPathDocument mithilfe des XPathDocument Konstruktors erstellen, werden Die 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 finden Sie wichtige Hinweise, die Sie berücksichtigen sollten, 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 Ladevorgang beginnt an diesem Punkt.
Um Leerraum beizubehalten, verwenden Sie den Konstruktor, der XPathDocument ein XmlSpace Objekt als Parameter akzeptiert.

Gilt für:

XPathDocument(TextReader)

Quelle:: XPathDocument.cs

Quelle:: XPathDocument.cs

Quelle:: XPathDocument.cs

Quelle:: XPathDocument.cs

Quelle:: XPathDocument.cs

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

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

XmlException

Fehler in den XML-Daten. Die XPathDocument bleibt leer.

ArgumentNullException

Das TextReader als Parameter übergebene 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)

Quelle:: XPathDocument.cs

Quelle:: XPathDocument.cs

Quelle:: XPathDocument.cs

Quelle:: XPathDocument.cs

Quelle:: XPathDocument.cs

Initialisiert eine neue Instanz der XPathDocument Klasse aus den XML-Daten in der Datei, die mit der angegebenen Leerraumbehandlung angegeben ist.

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

XmlException

Fehler in den XML-Daten. Die XPathDocument bleibt leer.

ArgumentNullException

Der Dateipfadparameter oder XmlSpace Objektparameter ist null.

Hinweise

Das XmlSpace als Parameter übergebene Objekt gibt an, ob Leerraum beibehalten werden soll. 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 Leerraumbehandlungsoptionen.

Weitere Informationen

XmlSpace

Gilt für:

XPathDocument(XmlReader, XmlSpace)

Quelle:: XPathDocument.cs

Quelle:: XPathDocument.cs

Quelle:: XPathDocument.cs

Quelle:: XPathDocument.cs

Quelle:: XPathDocument.cs

Initialisiert eine neue Instanz der XPathDocument Klasse aus den XML-Daten, die im angegebenen XmlReader Objekt mit der angegebenen Leerraumbehandlung enthalten sind.

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

XmlException

Fehler in den XML-Daten. Die XPathDocument bleibt leer.

ArgumentNullException

Der XmlReader Objektparameter oder XmlSpace Objektparameter ist null.

Hinweise

Das XmlSpace als Parameter übergebene Objekt gibt an, ob Leerraum beibehalten werden soll. 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 Leerraumbehandlungsoptionen.

Weitere Informationen

XmlSpace

Gilt für:

Feedback

War diese Seite hilfreich?