XDocument.Parse Methode

Definition

Namespace:: System.Xml.Linq

Assemblys:: System.Xml.Linq.dll, System.Xml.XDocument.dll

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

Assembly:: System.Xml.XDocument.dll

Assembly:: System.Xml.Linq.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.

Erstellt eine neue XDocument Aus einer Zeichenfolge, optional beibehalten Leerzeichen, Festlegen des Basis-URI und Aufbewahren von Zeileninformationen.

Überlädt

Name	Beschreibung
Parse(String)	Erstellt eine neue XDocument aus einer Zeichenfolge.
Parse(String, LoadOptions)	Erstellt eine neue XDocument Aus einer Zeichenfolge, optional beibehalten Leerzeichen, Festlegen des Basis-URI und Aufbewahren von Zeileninformationen.

Beispiele

Im folgenden Beispiel wird eine Zeichenfolge erstellt, die XML enthält. Anschließend analysiert sie die Zeichenfolge in eine XDocument.

string str =
@"<?xml version=""1.0""?>
<!-- comment at the root level -->
<Root>
    <Child>Content</Child>
</Root>";
XDocument doc = XDocument.Parse(str);
Console.WriteLine(doc);

Dim str As String = _
    "<?xml version= '1.0'?>" & _
    "<!-- comment at the root level -->" & _
    "<Root>" & _
    "  <Child>Content</Child>" & _
    "</Root>"

Dim doc As XDocument = XDocument.Parse(str)
Console.WriteLine(doc)

Dieses Beispiel erzeugt die folgende Ausgabe:

<!-- comment at the root level -->
<Root>
  <Child>Content</Child>
</Root>

Hinweise

Diese Methode analysiert eine Zeichenfolge und erstellt eine XML-Struktur.

Parse(String)

Quelle:: XDocument.cs

Quelle:: XDocument.cs

Quelle:: XDocument.cs

Quelle:: XDocument.cs

Quelle:: XDocument.cs

Erstellt eine neue XDocument aus einer Zeichenfolge.

public:
 static System::Xml::Linq::XDocument ^ Parse(System::String ^ text);

public static System.Xml.Linq.XDocument Parse(string text);

static member Parse : string -> System.Xml.Linq.XDocument

Public Shared Function Parse (text As String) As XDocument

Parameter

text: String

Eine Zeichenfolge, die XML enthält.

Gibt zurück

XDocument

Eine XDocument aufgefüllte Zeichenfolge, die XML enthält.

Beispiele

Im folgenden Beispiel wird eine Zeichenfolge erstellt, die XML enthält. Anschließend analysiert sie die Zeichenfolge in eine XDocument.

string str =
@"<?xml version=""1.0""?>
<!-- comment at the root level -->
<Root>
    <Child>Content</Child>
</Root>";
XDocument doc = XDocument.Parse(str);
Console.WriteLine(doc);

Dim str As String = _
    "<?xml version= '1.0'?>" & _
    "<!-- comment at the root level -->" & _
    "<Root>" & _
    "  <Child>Content</Child>" & _
    "</Root>"

Dim doc As XDocument = XDocument.Parse(str)
Console.WriteLine(doc)

Dieses Beispiel erzeugt die folgende Ausgabe:

<!-- comment at the root level -->
<Root>
  <Child>Content</Child>
</Root>

Hinweise

Diese Methode behält keinen Leerraum bei. Wenn Sie Leerraum in der XML-Struktur beibehalten möchten, verwenden Sie die Überladung dieser Parse LoadOptions Elemente als Parameter.

Weitere Informationen finden Sie unter Beibehalten des Leerraums beim Laden oder Analysieren von XML und Beibehalten von Leerzeichen beim Serialisieren.

LINQ to XML-Ladefunktionalität basiert auf XmlReader. Daher können Sie ausnahmen erfassen, die von den XmlReader.Create Überladungsmethoden und den XmlReader Methoden ausgelöst werden, die das Dokument lesen und analysieren.

Weitere Informationen

Gilt für:

Parse(String, LoadOptions)

Quelle:: XDocument.cs

Quelle:: XDocument.cs

Quelle:: XDocument.cs

Quelle:: XDocument.cs

Quelle:: XDocument.cs

Erstellt eine neue XDocument Aus einer Zeichenfolge, optional beibehalten Leerzeichen, Festlegen des Basis-URI und Aufbewahren von Zeileninformationen.

public:
 static System::Xml::Linq::XDocument ^ Parse(System::String ^ text, System::Xml::Linq::LoadOptions options);

public static System.Xml.Linq.XDocument Parse(string text, System.Xml.Linq.LoadOptions options);

static member Parse : string * System.Xml.Linq.LoadOptions -> System.Xml.Linq.XDocument

Public Shared Function Parse (text As String, options As LoadOptions) As XDocument

Parameter

text: String

Eine Zeichenfolge, die XML enthält.

options: LoadOptions

Ein LoadOptions Wert, der das Leerzeichenverhalten angibt und ob Basis-URI und Zeileninformationen geladen werden sollen.

Gibt zurück

XDocument

Eine XDocument aufgefüllte Zeichenfolge, die XML enthält.

Beispiele

Im folgenden Beispiel wird eine Zeichenfolge in eine XDocument.

string str =
@"<?xml version=""1.0""?>
<!-- comment at the root level -->
<Root>
    <Child>Content</Child>
</Root>";
XDocument doc1 = XDocument.Parse(str, LoadOptions.PreserveWhitespace);
Console.WriteLine("nodes when preserving whitespace: {0}", doc1.DescendantNodes().Count());
XDocument doc2 = XDocument.Parse(str, LoadOptions.None);
Console.WriteLine("nodes when not preserving whitespace: {0}", doc2.DescendantNodes().Count());

Dim str As String = _
"<?xml version= '1.0'?>" & Environment.NewLine & _
"<!-- comment at the root level -->" & Environment.NewLine & _
"<Root>" & Environment.NewLine & _
"    <Child>Content</Child>"  & Environment.NewLine & _
"</Root>"

Dim doc1 As XDocument = XDocument.Parse(str, LoadOptions.PreserveWhitespace)
Console.WriteLine("nodes when preserving whitespace: {0}", doc1.DescendantNodes().Count())
Dim doc2 As XDocument = XDocument.Parse(str, LoadOptions.None)
Console.WriteLine("nodes when not preserving whitespace: {0}", doc2.DescendantNodes().Count())

Dieses Beispiel erzeugt die folgende Ausgabe:

nodes when preserving whitespace: 8
nodes when not preserving whitespace: 4

Hinweise

Wenn der Quell-XML-Code eingerückt ist, bewirkt das Festlegen des PreserveWhitespace Flags options , dass der Leser den gesamten Leerraum im Quell-XML-Code liest. Knoten des Typs XText werden sowohl für signifikante als auch für unbedeutende Leerräume erstellt.

Wenn der Quell-XML-Code eingerückt ist, wird das PreserveWhitespace Flag options nicht festgelegt, wodurch der Leser den gesamten unbedeutenden Leerraum im Quell-XML-Code ignoriert. Die XML-Struktur wird ohne Textknoten für unbedeuteten Leerraum erstellt.

Wenn der Quell-XML-Code nicht eingerückt ist, hat das Festlegen des PreserveWhitespace Flags options keine Auswirkung. Erheblicher Leerraum bleibt erhalten, und es gibt keine Spanne von unbedeutenden Leerzeichen, die die Erstellung von mehr Leerraum-Textknoten verursachen könnten.

Weitere Informationen finden Sie unter Beibehalten des Leerraums beim Laden oder Analysieren von XML und Beibehalten von Leerzeichen beim Serialisieren.

Die Einstellung SetBaseUri ist beim Analysieren aus einem String.

Es gibt eine Leistungseinbuße, wenn Sie die SetLineInfo Kennzeichnung festlegen.

Die Zeileninformationen sind unmittelbar nach dem Laden des XML-Dokuments genau. Wenn Sie die XML-Struktur nach dem Laden des Dokuments ändern, können die Zeileninformationen bedeutungslos werden.

Weitere Informationen

Gilt für:

Feedback

War diese Seite hilfreich?