架构xref:System.Data.DataSet(其表、 列、 关系和约束) 可以定义,以编程方式创建的填充或FillSchema方法xref:System.Data.Common.DataAdapter,或从已加载XML 文档。 若要加载数据集架构信息从 XML 文档,您可以使用ReadXmlSchema或InferXmlSchema方法数据集. ReadXmlSchema允许您加载或推断数据集从包含 XML 架构定义语言 (XSD) 架构或包含内联 XML 架构的 XML 文档的文档的架构信息。 InferXmlSchema ,可忽略的某些指定的 XML 命名空间推断 XML 文档中的架构。
Note: 中的表顺序数据集当你使用 Web 服务或 XML 序列化传输时可能不会保留数据集内存中创建的使用 XSD 构造 (如嵌套关系)。 因此的接收方数据集不应依赖表顺序在这种情况下。 但是,表如果始终保留顺序的架构数据集传输从 XSD 文件,而不是要创建内存中读取。
ReadXmlSchema
若要加载的架构数据集从 XML 文档,而不加载任何数据,可以使用ReadXmlSchema方法数据集。 ReadXmlSchema创建数据集架构使用 XML 架构定义语言 (XSD) 架构定义。
ReadXmlSchema方法采用单个参数的文件名,流,或XmlReader包含要加载的 XML 文档。 XML 文档可以仅包含架构,也可以包含与包含数据的 XML 元素内联的架构。 有关编写内联架构作为 XML 架构的详细信息,请参阅派生数据集关系结构从 XML 架构 (XSD)。
如果 XML 文档传递给ReadXmlSchema不包含任何内联架构信息, ReadXmlSchema将推断 XML 文档中的元素中的架构。 如果数据集已包含架构,将通过添加新表,如果它们尚不存在扩展当前架构。 不会将新列添加到现有表中。 如果已添加的列中存在数据集但不兼容的类型与列中的 XML 中,将引发异常。 详细了解如何ReadXmlSchema推断架构从 XML 文档,请参阅推断数据集关系结构从 XML。
尽管ReadXmlSchema加载或推断的架构数据集,则ReadXml方法数据集加载或将它们都推断架构和 XML 文档中包含的数据。 有关详细信息,请参阅从 XML 加载数据集。
下面的代码示例显示如何加载数据集XML 文档或流中的架构。 第一个示例显示了 XML 架构的文件名传递给ReadXmlSchema方法。 第二个示例所示System.IO.StreamReader。
Dim dataSet As DataSet = New DataSet
dataSet.ReadXmlSchema("schema.xsd")
DataSet dataSet = new DataSet();
dataSet.ReadXmlSchema("schema.xsd");
Dim xmlStream As System.IO.StreamReader = New System.IO.StreamReader ("schema.xsd");
Dim dataSet As DataSet = New DataSet
dataSet.ReadXmlSchema(xmlStream)
xmlStream.Close()
System.IO.StreamReader xmlStream = new System.IO.StreamReader("schema.xsd");
DataSet dataSet = new DataSet();
dataSet.ReadXmlSchema(xmlStream);
xmlStream.Close();
InferXmlSchema
此外可以指示数据集推断 XML 文档使用从其架构InferXmlSchema方法数据集。 InferXmlSchema同时利用这两者的功能相同ReadXml与XmlReadMode的InferSchema (将数据加载以及推断架构),并且ReadXmlSchema如果正在读取的文档不包含任何内联架构。 但是, InferXmlSchema提供其他功能,使您可以指定特定的 XML 命名空间推断架构时被忽略。 InferXmlSchema采用两个必需的参数: 文件名、 流、 指定的 XML 文档的位置或XmlReader; 以及要忽略由该操作的 XML 命名空间的字符串数组。
例如,考虑以下 XML:
<NewDataSet xmlns:od="urn:schemas-microsoft-com:officedata">
<Categories>
<CategoryID od:adotype="3">1</CategoryID>
<CategoryName od:maxLength="15" od:adotype="130">Beverages</CategoryName>
<Description od:adotype="203">Soft drinks and teas</Description>
</Categories>
<Products>
<ProductID od:adotype="20">1</ProductID>
<ReorderLevel od:adotype="3">10</ReorderLevel>
<Discontinued od:adotype="11">0</Discontinued>
</Products>
</NewDataSet>
由于前面的 XML 文档中的元素指定的属性都ReadXmlSchema方法并ReadXml方法替换XmlReadMode的InferSchema会在文档中创建表的每个元素:类别, CategoryID, CategoryName,说明,产品, ProductID, ReorderLevel,和停止使用。 (有关详细信息,请参阅推断数据集关系结构从 XML。)但是,更为合适的结构就是创建仅类别并产品表,然后创建CategoryID, CategoryName,并描述中的列类别表中,和ProductID, ReorderLevel,和Discontinued中的列产品表。 若要确保推断的架构忽略在 XML 元素中指定的属性,请使用InferXmlSchema方法并指定的 XML 命名空间officedata被忽略,如中所示下面的示例。
Dim dataSet As DataSet = New DataSet
dataSet.InferXmlSchema("input_od.xml", New String() {"urn:schemas-microsoft-com:officedata"})
DataSet dataSet = new DataSet();
dataSet.InferXmlSchema("input_od.xml", new string[] "urn:schemas-microsoft-com:officedata");
请参阅
- 在数据集中使用 XML
- 从 XML 架构派生数据集关系结构 (XSD)
- 从 XML 推断数据集关系结构
- 从 XML 加载数据集
- 数据集、数据表和数据视图
- ADO.NET 托管提供程序和数据集开发人员中心
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
