XDocument.Parse Metode

Definisi

Ruang nama:

System.Xml.Linq

Rakitan:

netstandard.dll, System.Xml.XDocument.dll

Membuat baru XDocument dari string, secara opsional mempertahankan spasi kosong, mengatur URI dasar, dan mempertahankan informasi baris.

Overload

Nama	Deskripsi
Parse(String)	Membuat baru XDocument dari string.
Parse(String, LoadOptions)	Membuat baru XDocument dari string, secara opsional mempertahankan spasi kosong, mengatur URI dasar, dan mempertahankan informasi baris.

Contoh

Contoh berikut membuat string yang berisi XML. Kemudian menguraikan string ke dalam 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)

Contoh ini menghasilkan output berikut:

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

Keterangan

Metode ini mengurai string dan membuat pohon XML.

Parse(String)

Sumber:

XDocument.cs

Membuat baru XDocument dari string.

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

String yang berisi XML.

Mengembalikan

XDocument

Diisi XDocument dari string yang berisi XML.

Contoh

Contoh berikut membuat string yang berisi XML. Kemudian menguraikan string ke dalam 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)

Contoh ini menghasilkan output berikut:

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

Keterangan

Metode ini tidak mempertahankan spasi kosong. Jika Anda ingin mempertahankan spasi kosong di pohon XML, gunakan kelebihan beban Parse yang diambil LoadOptions sebagai parameter.

Untuk informasi selengkapnya, lihat Mempertahankan spasi kosong saat memuat atau mengurai XML dan Mempertahankan spasi kosong saat melakukan serialisasi.

Fungsionalitas pemuatan LINQ ke XML dibangun di atas XmlReader. Oleh karena itu, Anda mungkin menangkap pengecualian apa pun yang dilemparkan oleh XmlReader.Create metode kelebihan beban dan XmlReader metode yang membaca dan mengurai dokumen.

Lihat juga

• Load
• Save
• WriteTo(XmlWriter)
• Gambaran umum LINQ ke XML
• Cara mengurai string

Parse(String, LoadOptions)

Sumber:

XDocument.cs

Membuat baru XDocument dari string, secara opsional mempertahankan spasi kosong, mengatur URI dasar, dan mempertahankan informasi baris.

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

String yang berisi XML.

options

LoadOptions

LoadOptions yang menentukan perilaku spasi kosong, dan apakah akan memuat URI dasar dan informasi baris.

Mengembalikan

XDocument

Diisi XDocument dari string yang berisi XML.

Contoh

Contoh berikut menguraikan string ke dalam 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())

Contoh ini menghasilkan output berikut:

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

Keterangan

Jika XML sumber diindentasi, mengatur PreserveWhitespace bendera di options menyebabkan pembaca membaca semua spasi kosong di XML sumber. Simpul jenis XText dibuat untuk ruang putih yang signifikan dan tidak signifikan.

Jika XML sumber diindentasi, tidak mengatur PreserveWhitespace bendera di options menyebabkan pembaca mengabaikan semua spasi kosong yang tidak signifikan di XML sumber. Pohon XML dibuat tanpa simpul teks apa pun untuk spasi kosong yang tidak signifikan.

Jika XML sumber tidak diindentasi, pengaturan PreserveWhitespace bendera di options tidak berpengaruh. Ruang putih yang signifikan masih dipertahankan, dan tidak ada rentang ruang putih yang tidak signifikan yang dapat menyebabkan pembuatan node teks spasi yang lebih putih.

Untuk informasi selengkapnya, lihat Mempertahankan spasi kosong saat memuat atau mengurai XML dan Mempertahankan spasi kosong saat melakukan serialisasi.

Pengaturan SetBaseUri tidak valid saat mengurai Stringdari .

Ada penalti performa jika Anda mengatur SetLineInfo bendera.

Informasi baris akurat segera setelah memuat dokumen XML. Jika Anda mengubah pohon XML setelah memuat dokumen, informasi baris mungkin menjadi tidak berarti.

Fungsionalitas pemuatan LINQ ke XML dibangun di atas XmlReader. Oleh karena itu, Anda mungkin menangkap pengecualian apa pun yang dilemparkan oleh XmlReader.Create metode kelebihan beban dan XmlReader metode yang membaca dan mengurai dokumen.

Lihat juga

• Load
• Save
• WriteTo(XmlWriter)
• Gambaran umum LINQ ke XML
• Cara mengurai string