XDocument.Load Metode

Definisi

Ruang nama:

System.Xml.Linq

Rakitan:

netstandard.dll, System.Xml.XDocument.dll

Membuat baru XDocument dari file yang ditentukan oleh URI, dari TextReader, atau dari XmlReader.

Overload

Nama	Deskripsi
Load(Stream)	Membuat instans baru XDocument dengan menggunakan aliran yang ditentukan.
Load(TextReader)	Membuat baru XDocument dari TextReader.
Load(String)	Membuat baru XDocument dari file.
Load(XmlReader)	Membuat baru XDocument dari XmlReader.
Load(Stream, LoadOptions)	Membuat instans baru XDocument dengan menggunakan aliran yang ditentukan, secara opsional mempertahankan ruang kosong, mengatur URI dasar, dan mempertahankan informasi baris.
Load(TextReader, LoadOptions)	Membuat baru XDocument dari TextReader, secara opsional mempertahankan spasi kosong, mengatur URI dasar, dan mempertahankan informasi baris.
Load(String, LoadOptions)	Membuat baru XDocument dari file, secara opsional mempertahankan spasi kosong, mengatur URI dasar, dan mempertahankan informasi baris.
Load(XmlReader, LoadOptions)	XDocument Memuat dari XmlReader, secara opsional mengatur URI dasar, dan mempertahankan informasi baris.

Keterangan

Dengan menggunakan salah satu kelebihan beban metode ini, Anda dapat memuat XDocument dari file, TextReader, atau XmlReader.

Untuk membuat XDocument dari string yang berisi XML, gunakan Parse.

Load(Stream)

Sumber:

XDocument.cs

Membuat instans baru XDocument dengan menggunakan aliran yang ditentukan.

public:
 static System::Xml::Linq::XDocument ^ Load(System::IO::Stream ^ stream);

public static System.Xml.Linq.XDocument Load(System.IO.Stream stream);

static member Load : System.IO.Stream -> System.Xml.Linq.XDocument

Public Shared Function Load (stream As Stream) As XDocument

Parameter

stream

Stream

Aliran yang berisi data XML.

Mengembalikan

XDocument

Objek XDocument yang membaca data yang terkandung dalam aliran.

Keterangan

Jika Anda ingin mengontrol opsi beban, gunakan Load kelebihan beban yang mengambil LoadOptions sebagai parameter.

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.

Jika Anda harus memodifikasi XmlReaderSettings, ikuti langkah-langkah berikut:

1. XmlReader Buat dengan memanggil salah Create satu kelebihan beban yang diambil XmlReaderSettings sebagai parameter.

2. Teruskan XmlReader ke salah Load satu kelebihan beban XDocument yang diambil XmlReader sebagai parameter.

Load(TextReader)

Sumber:

XDocument.cs

Membuat baru XDocument dari TextReader.

public:
 static System::Xml::Linq::XDocument ^ Load(System::IO::TextReader ^ textReader);

public static System.Xml.Linq.XDocument Load(System.IO.TextReader textReader);

static member Load : System.IO.TextReader -> System.Xml.Linq.XDocument

Public Shared Function Load (textReader As TextReader) As XDocument

Parameter

textReader

TextReader

Yang TextReader berisi konten untuk XDocument.

Mengembalikan

XDocument

Yang XDocument berisi konten dari yang ditentukan TextReader.

Contoh

Contoh berikut membuat dokumen dari StringReader.

TextReader tr = new StringReader("<Root>Content</Root>");
XDocument doc = XDocument.Load(tr);
Console.WriteLine(doc);

Dim tr As TextReader = New StringReader("<Root>Content</Root>")
Dim doc As XDocument = XDocument.Load(tr)
Console.WriteLine(doc)

Contoh ini menghasilkan output berikut:

<Root>Content</Root>

Keterangan

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

• Parse
• Save
• WriteTo(XmlWriter)
• Gambaran umum LINQ ke XML
• Mengkueri XDocument vs. mengkueri XElement

Load(String)

Sumber:

XDocument.cs

Membuat baru XDocument dari file.

public:
 static System::Xml::Linq::XDocument ^ Load(System::String ^ uri);

public static System.Xml.Linq.XDocument Load(string uri);

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

Public Shared Function Load (uri As String) As XDocument

Parameter

uri

String

String URI yang mereferensikan file untuk dimuat ke dalam baru XDocument.

Mengembalikan

XDocument

Yang XDocument berisi konten file yang ditentukan.

Contoh

Contoh berikut menunjukkan cara memuat XDocument dari file.

Contoh ini menggunakan dokumen XML berikut:

File XML Sampel: Pesanan Pembelian Umum (LINQ ke XML)

XDocument doc = XDocument.Load("PurchaseOrder.xml");
Console.WriteLine(doc);

Dim doc As XDocument = XDocument.Load("PurchaseOrder.xml")
Console.WriteLine(doc)

Contoh ini menghasilkan output berikut:

<PurchaseOrder PurchaseOrderNumber="99503" OrderDate="1999-10-20">
  <Address Type="Shipping">
    <Name>Ellen Adams</Name>
    <Street>123 Maple Street</Street>
    <City>Mill Valley</City>
    <State>CA</State>
    <Zip>10999</Zip>
    <Country>USA</Country>
  </Address>
  <Address Type="Billing">
    <Name>Tai Yee</Name>
    <Street>8 Oak Avenue</Street>
    <City>Old Town</City>
    <State>PA</State>
    <Zip>95819</Zip>
    <Country>USA</Country>
  </Address>
  <DeliveryNotes>Please leave packages in shed by driveway.</DeliveryNotes>
  <Items>
    <Item PartNumber="872-AA">
      <ProductName>Lawnmower</ProductName>
      <Quantity>1</Quantity>
      <USPrice>148.95</USPrice>
      <Comment>Confirm this is electric</Comment>
    </Item>
    <Item PartNumber="926-AA">
      <ProductName>Baby Monitor</ProductName>
      <Quantity>2</Quantity>
      <USPrice>39.98</USPrice>
      <ShipDate>1999-05-21</ShipDate>
    </Item>
  </Items>
</PurchaseOrder>

Keterangan

Metode ini menggunakan yang mendasar XmlReader untuk membaca XML ke dalam pohon XML.

Gunakan Parse untuk membuat XDocument dari string yang berisi XML.

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

• Parse
• Save
• WriteTo(XmlWriter)
• Gambaran umum LINQ ke XML
• Mengkueri XDocument vs. mengkueri XElement

Load(XmlReader)

Sumber:

XDocument.cs

Membuat baru XDocument dari XmlReader.

public:
 static System::Xml::Linq::XDocument ^ Load(System::Xml::XmlReader ^ reader);

public static System.Xml.Linq.XDocument Load(System.Xml.XmlReader reader);

static member Load : System.Xml.XmlReader -> System.Xml.Linq.XDocument

Public Shared Function Load (reader As XmlReader) As XDocument

Parameter

reader

XmlReader

Yang XmlReader berisi konten untuk XDocument.

Mengembalikan

XDocument

Yang XDocument berisi konten dari yang ditentukan XmlReader.

Contoh

Contoh berikut membuat dokumen DOM, membuat XmlNodeReader dari dokumen DOM, membuat XDocument menggunakan XmlNodeReader.

// Create a DOM document with some content.
XmlDocument doc = new XmlDocument();
XmlElement child = doc.CreateElement("Child");
child.InnerText = "child contents";
XmlElement root = doc.CreateElement("Root");
root.AppendChild(child);
doc.AppendChild(root);

// create a reader and move to the content
using (XmlNodeReader nodeReader = new XmlNodeReader(doc)) {
    // the reader must be in the Interactive state in order to
    // create a LINQ to XML tree from it.
    nodeReader.MoveToContent();

    XDocument xRoot = XDocument.Load(nodeReader);
    Console.WriteLine(xRoot);
}

' Create a DOM document with some content.
Dim doc As XmlDocument = New XmlDocument()
Dim child As XmlElement = doc.CreateElement("Child")
child.InnerText = "child contents"
Dim root As XmlElement = doc.CreateElement("Root")
root.AppendChild(child)
doc.AppendChild(root)

' create a reader and move to the content
Using nodeReader = New XmlNodeReader(doc)
    ' the reader must be in the Interactive state in order to
    ' create a LINQ to XML tree from it.
    nodeReader.MoveToContent()

    Dim xRoot As XDocument = XDocument.Load(nodeReader)
    Console.WriteLine(xRoot)
End Using

Contoh ini menghasilkan output berikut:

<Root>
  <Child>child contents</Child>
</Root>

Keterangan

Salah satu kemungkinan penggunaan untuk metode ini adalah membuat salinan dokumen DOM di pohon LINQ ke XML. Untuk melakukan ini, Anda membuat XmlNodeReader dari dokumen DOM, lalu menggunakan XmlNodeReader untuk membuat XDocument.

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

• Parse
• Save
• WriteTo(XmlWriter)
• Gambaran umum LINQ ke XML
• Mengkueri XDocument vs. mengkueri XElement

Load(Stream, LoadOptions)

Sumber:

XDocument.cs

Membuat instans baru XDocument dengan menggunakan aliran yang ditentukan, secara opsional mempertahankan ruang kosong, mengatur URI dasar, dan mempertahankan informasi baris.

public:
 static System::Xml::Linq::XDocument ^ Load(System::IO::Stream ^ stream, System::Xml::Linq::LoadOptions options);

public static System.Xml.Linq.XDocument Load(System.IO.Stream stream, System.Xml.Linq.LoadOptions options);

static member Load : System.IO.Stream * System.Xml.Linq.LoadOptions -> System.Xml.Linq.XDocument

Public Shared Function Load (stream As Stream, options As LoadOptions) As XDocument

Parameter

stream

Stream

Aliran yang berisi data XML.

options

LoadOptions

LoadOptions Yang menentukan apakah akan memuat URI dasar dan informasi baris.

Mengembalikan

XDocument

Objek XDocument yang membaca data yang terkandung dalam aliran.

Keterangan

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.

Jika Anda harus memodifikasi XmlReaderSettings, ikuti langkah-langkah berikut:

1. XmlReader Buat dengan memanggil salah Create satu kelebihan beban yang mengambil XmlReaderSettings sebagai parameter.

2. Teruskan XmlReader ke salah Load satu kelebihan beban XDocument yang diambil XmlReader sebagai parameter.

Load(TextReader, LoadOptions)

Sumber:

XDocument.cs

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

public:
 static System::Xml::Linq::XDocument ^ Load(System::IO::TextReader ^ textReader, System::Xml::Linq::LoadOptions options);

public static System.Xml.Linq.XDocument Load(System.IO.TextReader textReader, System.Xml.Linq.LoadOptions options);

static member Load : System.IO.TextReader * System.Xml.Linq.LoadOptions -> System.Xml.Linq.XDocument

Public Shared Function Load (textReader As TextReader, options As LoadOptions) As XDocument

Parameter

textReader

TextReader

Yang TextReader berisi konten untuk XDocument.

options

LoadOptions

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

Mengembalikan

XDocument

Yang XDocument berisi XML yang dibaca dari yang ditentukan TextReader.

Contoh

Contoh berikut membuat dokumen dari StringReader.

TextReader sr;
int whiteSpaceNodes;

sr = new StringReader("<Root> <Child> </Child> </Root>");
XDocument xmlTree1 = XDocument.Load(sr, LoadOptions.None);
sr.Close();
whiteSpaceNodes = xmlTree1
    .Element("Root")
    .DescendantNodesAndSelf()
    .OfType<XText>()
    .Where(tNode => tNode.ToString().Trim().Length == 0)
    .Count();
Console.WriteLine("Count of white space nodes (not preserving whitespace): {0}", whiteSpaceNodes);

sr = new StringReader("<Root> <Child> </Child> </Root>");
XDocument xmlTree2 = XDocument.Load(sr, LoadOptions.PreserveWhitespace);
sr.Close();
whiteSpaceNodes = xmlTree2
    .Element("Root")
    .DescendantNodesAndSelf()
    .OfType<XText>()
    .Where(tNode => tNode.ToString().Trim().Length == 0)
    .Count();
Console.WriteLine("Count of white space nodes (preserving whitespace): {0}", whiteSpaceNodes);

Dim sr As TextReader
Dim whiteSpaceNodes As Integer

sr = New StringReader("<Root> <Child> </Child> </Root>")
Dim xmlTree1 As XDocument = XDocument.Load(sr, LoadOptions.None)
sr.Close()
whiteSpaceNodes = xmlTree1 _
              .Element("Root") _
              .DescendantNodesAndSelf() _
              .OfType(Of XText)() _
              .Where(Function(ByVal tNode As XNode) tNode. _
                  ToString().Trim().Length = 0).Count()
Console.WriteLine("Count of white space nodes (not preserving whitespace): {0}", whiteSpaceNodes)

sr = New StringReader("<Root> <Child> </Child> </Root>")
Dim xmlTree2 As XDocument = XDocument.Load(sr, LoadOptions.PreserveWhitespace)
sr.Close()
whiteSpaceNodes = xmlTree2 _
              .Element("Root") _
              .DescendantNodesAndSelf() _
              .OfType(Of XText)() _
              .Where(Function(ByVal tNode As XNode) tNode. _
                  ToString().Trim().Length = 0).Count()
Console.WriteLine("Count of white space nodes (preserving whitespace): {0}", whiteSpaceNodes)

Contoh ini menghasilkan output berikut:

Count of white space nodes (not preserving whitespace): 0
Count of white space nodes (preserving whitespace): 3

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.

Gunakan Parse untuk membuat XElement dari string yang berisi XML.

Pengaturan SetBaseUri tidak valid saat memuat dari TextReader.

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

• Parse
• Save
• WriteTo(XmlWriter)
• Gambaran umum LINQ ke XML
• Mengkueri XDocument vs. mengkueri XElement

Load(String, LoadOptions)

Sumber:

XDocument.cs

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

public:
 static System::Xml::Linq::XDocument ^ Load(System::String ^ uri, System::Xml::Linq::LoadOptions options);

public static System.Xml.Linq.XDocument Load(string uri, System.Xml.Linq.LoadOptions options);

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

Public Shared Function Load (uri As String, options As LoadOptions) As XDocument

Parameter

uri

String

String URI yang mereferensikan file untuk dimuat ke dalam baru XDocument.

options

LoadOptions

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

Mengembalikan

XDocument

Yang XDocument berisi konten file yang ditentukan.

Contoh

Contoh berikut menunjukkan cara memuat XDocument dari file.

Contoh ini menggunakan dokumen XML berikut:

File XML Sampel: Pesanan Pembelian Umum (LINQ ke XML)

XDocument doc1 = XDocument.Load("PurchaseOrder.xml", LoadOptions.None);
Console.WriteLine("nodes if not preserving whitespace: {0}", doc1.DescendantNodes().Count());

XDocument doc2 = XDocument.Load("PurchaseOrder.xml", LoadOptions.PreserveWhitespace);
Console.WriteLine("nodes if preserving whitespace: {0}", doc2.DescendantNodes().Count());

Dim doc1 As XDocument = XDocument.Load("PurchaseOrder.xml", LoadOptions.None)
Console.WriteLine("nodes if not preserving whitespace: {0}", doc1.DescendantNodes().Count())

Dim doc2 As XDocument = XDocument.Load("PurchaseOrder.xml", LoadOptions.PreserveWhitespace)
Console.WriteLine("nodes if preserving whitespace: {0}", doc2.DescendantNodes().Count())

Contoh ini menghasilkan output berikut:

nodes if not preserving whitespace: 48
nodes if preserving whitespace: 82

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.

Gunakan Parse untuk membuat XDocument dari string yang berisi XML.

Ada penalti performa jika Anda mengatur SetBaseUri dan SetLineInfo bendera.

URI dasar dan informasi baris akurat segera setelah memuat dokumen XML. Jika Anda mengubah pohon XML setelah memuat dokumen, URI dasar dan 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

• Parse
• Save
• WriteTo(XmlWriter)
• Gambaran umum LINQ ke XML
• Mengkueri XDocument vs. mengkueri XElement

Load(XmlReader, LoadOptions)

Sumber:

XDocument.cs

XDocument Memuat dari XmlReader, secara opsional mengatur URI dasar, dan mempertahankan informasi baris.

public:
 static System::Xml::Linq::XDocument ^ Load(System::Xml::XmlReader ^ reader, System::Xml::Linq::LoadOptions options);

public static System.Xml.Linq.XDocument Load(System.Xml.XmlReader reader, System.Xml.Linq.LoadOptions options);

static member Load : System.Xml.XmlReader * System.Xml.Linq.LoadOptions -> System.Xml.Linq.XDocument

Public Shared Function Load (reader As XmlReader, options As LoadOptions) As XDocument

Parameter

reader

XmlReader

XmlReader yang akan dibaca untuk konten XDocument.

options

LoadOptions

LoadOptions Yang menentukan apakah akan memuat URI dasar dan informasi baris.

Mengembalikan

XDocument

Yang XDocument berisi XML yang dibaca dari yang ditentukan XmlReader.

Contoh

Contoh berikut memuat informasi baris yang dimuatnya XmlReaderdari . Kemudian mencetak informasi baris.

string markup =
@"<Root>
    <Child>
        <GrandChild/>
    </Child>
</Root>";

// Create a reader and move to the content.
using (XmlReader nodeReader = XmlReader.Create(new StringReader(markup)))
{
    // the reader must be in the Interactive state in order to
    // Create a LINQ to XML tree from it.
    nodeReader.MoveToContent();

    XDocument xRoot = XDocument.Load(nodeReader, LoadOptions.SetLineInfo);
    Console.WriteLine("{0}{1}{2}",
        "Element Name".PadRight(20),
        "Line".PadRight(5),
        "Position");
    Console.WriteLine("{0}{1}{2}",
        "------------".PadRight(20),
        "----".PadRight(5),
        "--------");
    foreach (XElement e in xRoot.Elements("Root").DescendantsAndSelf())
        Console.WriteLine("{0}{1}{2}",
            ("".PadRight(e.Ancestors().Count() * 2) + e.Name).PadRight(20),
            ((IXmlLineInfo)e).LineNumber.ToString().PadRight(5),
            ((IXmlLineInfo)e).LinePosition);
}

Dim markup As String = _
    "<Root>" & Environment.NewLine & _
    "    <Child>" & Environment.NewLine & _
    "        <GrandChild/>" & Environment.NewLine & _
    "    </Child>" & Environment.NewLine & _
    "</Root>"

' Create a reader and move to the content.
Using nodeReader As XmlReader = XmlReader.Create(New StringReader(markup))

    ' The reader must be in the Interactive state in order to
    ' create a LINQ to XML tree from it.
    nodeReader.MoveToContent()

    Dim xRoot As XDocument = XDocument.Load(nodeReader, LoadOptions.SetLineInfo)
    Console.WriteLine("{0}{1}{2}", _
        "Element Name".PadRight(20), _
        "Line".PadRight(5), _
        "Position")
    Console.WriteLine("{0}{1}{2}", _
        "------------".PadRight(20), _
        "----".PadRight(5), _
        "--------")
    For Each e As XElement In xRoot.Elements("Root").DescendantsAndSelf()
        Console.WriteLine("{0}{1}{2}", _
            ("".PadRight(e.Ancestors().Count() * 2) & e.Name.ToString()).PadRight(20), _
            (DirectCast(e, IXmlLineInfo)).LineNumber.ToString().PadRight(5), _
            (DirectCast(e, IXmlLineInfo)).LinePosition)
    Next
End Using

Contoh ini menghasilkan output berikut:

Element Name        Line Position
------------        ---- --------
Root                1    2
  Child             2    6
    GrandChild      3    10

Keterangan

Dengan membuat XmlNodeReader dari dokumen DOM, lalu menggunakan XmlNodeReader untuk membuat XElement, metode ini dapat digunakan untuk membuat salinan dokumen DOM di pohon LINQ ke XML.

Gunakan Parse untuk membuat XDocument dari string yang berisi XML.

Pengaturan PreserveWhitespace tidak valid saat memuat dari XmlReader. XmlReader akan dikonfigurasi untuk membaca spasi kosong atau tidak. Pohon LINQ ke XML akan diisi dengan simpul spasi kosong yang dimunculkan pembaca. Ini akan menjadi perilaku terlepas dari apakah PreserveWhitespace diatur atau tidak.

mungkin XmlReader memiliki URI dasar yang valid atau tidak. Jika Anda mengatur SetBaseUri, URI dasar akan diatur di pohon XML dari URI dasar yang dilaporkan oleh XmlReader.

mungkin XmlReader memiliki informasi baris yang valid atau tidak. Jika Anda mengatur SetLineInfo, informasi baris akan diatur di pohon XML dari informasi baris yang dilaporkan oleh XmlReader.

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

• WriteTo(XmlWriter)
• Save
• Parse
• Gambaran umum LINQ ke XML
• Cara membaca dan menulis dokumen yang dikodekan