XmlDataDocument.Load 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
使用指定的数据源加载， XmlDataDocument 并将该数据源与加载的数据同步 DataSet 。
重载
| 名称 | 说明 |
|---|---|
| Load(Stream) |
|
| Load(TextReader) |
|
| Load(String) |
|
| Load(XmlReader) |
|
注解
注释
若要以关系方式查看 XML 数据，必须先指定用于数据映射的架构。 这可以通过调用 ReadXmlSchema 方法或通过手动创建表和列 DataSet 来完成。 必须在调用 Load之前完成此步骤。
XmlDataDocument 不支持创建实体引用。 如果数据包含实体引用，该方法 Load 将解析并扩展任何实体引用。 但是，如果使用Load采用参数的重载，则必须指定XmlReader可以解析实体的重载XmlReader。
Load(Stream)
- Source:
- XmlDataDocument.cs
- Source:
- XmlDataDocument.cs
- Source:
- XmlDataDocument.cs
- Source:
- XmlDataDocument.cs
- Source:
- 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 -> unitPublic Overrides Sub Load (inStream As Stream)参数
- inStream
- Stream
包含要加载的 XML 文档的流。
注解
XmlDataDocument 不支持创建实体引用。 如果数据包含实体引用，该方法 Load 将解析并扩展任何实体引用。
注释
若要以关系方式查看 XML 数据，必须先指定用于数据映射的架构。 这可以通过调用 ReadXmlSchema 方法或通过手动创建表和列 DataSet 来完成。 必须在调用 Load之前完成此步骤。
适用于
Load(TextReader)
- Source:
- XmlDataDocument.cs
- Source:
- XmlDataDocument.cs
- Source:
- XmlDataDocument.cs
- Source:
- XmlDataDocument.cs
- Source:
- XmlDataDocument.cs
XmlDataDocument从指定的TextReader值加载 。
public:
override void Load(System::IO::TextReader ^ txtReader);public override void Load(System.IO.TextReader txtReader);override this.Load : System.IO.TextReader -> unitPublic Overrides Sub Load (txtReader As TextReader)参数
- txtReader
- TextReader
TextReader用于将 XML 数据馈送到文档中。
注解
XmlDataDocument 不支持创建实体引用。 如果数据包含实体引用，该方法 Load 将解析并扩展任何实体引用。
注释
若要以关系方式查看 XML 数据，必须先指定用于数据映射的架构。 这可以通过调用 ReadXmlSchema 方法或通过手动创建表和列 DataSet 来完成。 必须在调用 Load之前完成此步骤。
适用于
Load(String)
- Source:
- XmlDataDocument.cs
- Source:
- XmlDataDocument.cs
- Source:
- XmlDataDocument.cs
- Source:
- XmlDataDocument.cs
- Source:
- XmlDataDocument.cs
XmlDataDocument加载使用指定的 URL。
public:
override void Load(System::String ^ filename);public override void Load(string filename);override this.Load : string -> unitPublic Overrides Sub Load (filename As String)参数
- filename
- String
包含要加载的 XML 文档的文件的 URL。
注解
XmlDataDocument 不支持创建实体引用。 如果数据包含实体引用，该方法 Load 将解析并扩展任何实体引用。
注释
若要以关系方式查看 XML 数据，必须先指定用于数据映射的架构。 这可以通过调用 ReadXmlSchema 方法或通过手动创建表和列 DataSet 来完成。 必须在调用 Load之前完成此步骤。
适用于
Load(XmlReader)
- Source:
- XmlDataDocument.cs
- Source:
- XmlDataDocument.cs
- Source:
- XmlDataDocument.cs
- Source:
- XmlDataDocument.cs
- Source:
- XmlDataDocument.cs
XmlDataDocument从指定的XmlReader值加载 。
public:
override void Load(System::Xml::XmlReader ^ reader);public override void Load(System.Xml.XmlReader reader);override this.Load : System.Xml.XmlReader -> unitPublic Overrides Sub Load (reader As XmlReader)参数
- reader
- XmlReader
XmlReader包含要加载的 XML 文档。
例外
加载的 XML 包含实体引用，读取器无法解析实体。
注解
XmlDataDocument 不支持创建实体引用。 如果数据源包含实体引用，则必须创建一个XmlValidatingReader属性EntityHandling设置为 EntityHandling.ExpandEntities（这是默认行为），并传递给XmlValidatingReaderLoad该方法。 如果不使用， 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 将引发异常。
如果读取器定位于对于文档的根级别来说无效的叶节点（如空白或属性节点），则读取器继续读取，直到定位在可用于根的节点上。 此时，文档开始加载。
