XmlDataDocument.Load 方法

定義

命名空間:

System.Xml

組件:

System.Data.Common.dll

利用指定的資料來源載入 ， XmlDataDocument 並將 與載入的資料同步 DataSet 。

多載

名稱	Description
Load(Stream)	從指定的串流載入 。XmlDataDocument
Load(TextReader)	從指定的 TextReader載入 XmlDataDocument 。
Load(String)	用指定的網址載入。XmlDataDocument
Load(XmlReader)	從指定的 XmlReader載入 XmlDataDocument 。

備註

備註

若要以關聯方式查看 XML 資料，首先必須指定用於資料映射的結構。 這可以透過呼叫 ReadXmlSchema 方法來完成，或是手動建立表格 DataSet 和欄位。 此步驟必須在呼叫 Load前完成。

XmlDataDocument 不支援建立實體參考。 若資料包含實體參考，該 Load 方法會解析並展開任何實體參考。 然而，如果你使用的 Load 是以 為 XmlReader 參數的超載，你必須指定一個 XmlReader 能解析實體的參數。

Load(Stream)

來源:

XmlDataDocument.cs

從指定的串流載入 。XmlDataDocument

public:
 override void Load(System::IO::Stream ^ inStream);

public override void Load(System.IO.Stream inStream);

override this.Load : System.IO.Stream -> unit

Public Overrides Sub Load (inStream As Stream)

參數

inStream

Stream

載入包含 XML 文件的串流。

備註

XmlDataDocument 不支援建立實體參考。 若資料包含實體參考，該 Load 方法會解析並展開任何實體參考。

備註

若要以關聯方式查看 XML 資料，首先必須指定用於資料映射的結構。 這可以透過呼叫 ReadXmlSchema 方法來完成，或是手動建立表格 DataSet 和欄位。 此步驟必須在呼叫 Load前完成。

Load(TextReader)

來源:

XmlDataDocument.cs

從指定的 TextReader載入 XmlDataDocument 。

public:
 override void Load(System::IO::TextReader ^ txtReader);

public override void Load(System.IO.TextReader txtReader);

override this.Load : System.IO.TextReader -> unit

Public Overrides Sub Load (txtReader As TextReader)

參數

txtReader

TextReader

它們 TextReader 用來將 XML 資料輸入文件。

備註

XmlDataDocument 不支援建立實體參考。 若資料包含實體參考，該 Load 方法會解析並展開任何實體參考。

備註

若要以關聯方式查看 XML 資料，首先必須指定用於資料映射的結構。 這可以透過呼叫 ReadXmlSchema 方法來完成，或是手動建立表格 DataSet 和欄位。 此步驟必須在呼叫 Load前完成。

Load(String)

來源:

XmlDataDocument.cs

用指定的網址載入。XmlDataDocument

public:
 override void Load(System::String ^ filename);

public override void Load(string filename);

override this.Load : string -> unit

Public Overrides Sub Load (filename As String)

參數

filename

String

載入包含 XML 文件的檔案 URL。

備註

XmlDataDocument 不支援建立實體參考。 若資料包含實體參考，該 Load 方法會解析並展開任何實體參考。

備註

若要以關聯方式查看 XML 資料，首先必須指定用於資料映射的結構。 這可以透過呼叫 ReadXmlSchema 方法來完成，或是手動建立表格 DataSet 和欄位。 此步驟必須在呼叫 Load前完成。

Load(XmlReader)

來源:

XmlDataDocument.cs

從指定的 XmlReader載入 XmlDataDocument 。

public:
 override void Load(System::Xml::XmlReader ^ reader);

public override void Load(System.Xml.XmlReader reader);

override this.Load : System.Xml.XmlReader -> unit

Public Overrides Sub Load (reader As XmlReader)

參數

reader

XmlReader

裡面 XmlReader 包含要載入的 XML 文件。

例外狀況

NotSupportedException

被載入的 XML 包含實體參考，讀取器無法解析實體。

備註

XmlDataDocument 不支援建立實體參考。 如果資料來源包含實體參考，你必須建立 XmlValidatingReader 一個，並將 EntityHandling 屬性設為 EntityHandling.ExpandEntities（這是預設行為），並將 傳給 XmlValidatingReader 該 Load 方法。 若不使用 ， XmlValidatingReader該 Load 方法會拋出例外。

此 Load 方法總是保留大量空白。 該 PreserveWhitespace 性質決定了白頻是否被保留。 預設是 false，空白區域不會被保留。

若讀取器處於初始狀態（即 ReadState=ReadState.Initial）， Load 則會消耗讀取器的完整內容，並從中找到的內容建立 DOM。

如果讀取器已經位於某個深度為「n」的節點上，此方法會載入該節點及所有後續兄弟節點，直到關閉深度「n」的末端標籤。 此結果如下。

如果目前節點及其後續的兄弟節點看起來與以下相似：

<!--comment--><element1>one</element1><element2>two</element2>

Load 拋出例外，因為文件中不能有兩個根級元素。 如果目前節點及其後續的兄弟節點看起來與以下相似：

<!--comment--><?process
    instruction?><!--comment--></endtag>

Load 將成功;然而，由於沒有根層元素，DOM 樹會不完整。 你必須在儲存文件前加入根層級元素;否則，方法 Save 會拋出例外。

如果讀取器位於檔根層級無效的分葉節點上（例如空格符或屬性節點），讀取器會繼續讀取，直到它位於可用於根目錄的節點上為止。 檔此時會開始載入。