大网数据广告活动
.NET 与 C# 开发

写入数据集内容作为 XML 数据

· 52CE 我爱测

在 ADO.NET 中可以编写 的 XML 表示形式(包含或不包含其架构)。 如果架构信息以内联形式包含在 XML 表示形式中,则使用 XML 架构定义语言 (XSD) 来编写。 架构包含 的表定义以及关系和约束定义。

在 ADO.NET 中可以编写 xref:System.Data.DataSet 的 XML 表示形式(包含或不包含其架构)。 如果架构信息以内联形式包含在 XML 表示形式中,则使用 XML 架构定义语言 (XSD) 来编写。 架构包含 xref:System.Data.DataSet 的表定义以及关系和约束定义。

当以 XML 数据形式编写 xref:System.Data.DataSet 时,xref:System.Data.DataSet 中的行将以它们的当前版本编写。 不过,也可以用 DiffGram 形式编写 xref:System.Data.DataSet,从而使行的当前值和原始值都将包含在内。

XML 表示形式xref:System.Data.DataSet可以写入到文件、 流, XmlWriter,或字符串。 这些选择在如何传输 xref:System.Data.DataSet 的 XML 表示形式方面提供了很大的灵活性。 若要获取的 XML 表示形式xref:System.Data.DataSet作为一个字符串,使用GetXml方法,如以下示例所示。

Dim xmlDS As String = custDS.GetXml()  
string xmlDS = custDS.GetXml();  

GetXml返回的 XML 表示形式xref:System.Data.DataSet不包含架构信息。 若要从架构信息写入xref:System.Data.DataSet(作为 XML 架构) 到一个字符串,使用GetXmlSchema。

若要编写xref:System.Data.DataSet到一个文件流,或XmlWriter,使用WriteXml方法。 第一个参数传递给WriteXml目标的 XML 输出。 例如,传递包含文件名的字符串System.IO.TextWriter对象,依次类推。 可以传递另一个可选参数XmlWriteMode来指定要写入的 XML 输出的方式。

下表显示的选项XmlWriteMode。

XmlWriteMode 选项 描述
IgnoreSchema 以 XML 数据形式编写 xref:System.Data.DataSet 的当前内容,不包含 XML 架构。 这是默认设置。
WriteSchema 以 XML 数据形式编写 xref:System.Data.DataSet 的当前内容,以关系结构作为内联 XML 架构。
DiffGram 以 DiffGram 形式编写整个 xref:System.Data.DataSet,包括原始值和当前值。 有关详细信息,请参阅Diffgram。

当编写的 XML 表示形式xref:System.Data.DataSet,其中包含DataRelation对象,您很可能希望生成的 XML 将每个关系嵌套在它们相关的父元素的子行。 若要完成此操作,设置嵌套的属性DataRelation到true添加时DataRelation到xref:System.Data.DataSet. 有关详细信息,请参阅嵌套 Datarelation。

下面是两个有关如何将 xref:System.Data.DataSet 的 XML 表示形式写入文件的示例。 第一个示例将生成的 XML 的文件名称的字符串作为传递WriteXml。 第二个示例传递System.IO.StreamWriter对象。

custDS.WriteXml("Customers.xml", XmlWriteMode.WriteSchema)  
custDS.WriteXml("Customers.xml", XmlWriteMode.WriteSchema);  
Dim xmlSW As System.IO.StreamWriter = New System.IO.StreamWriter("Customers.xml")  
custDS.WriteXml(xmlSW, XmlWriteMode.WriteSchema)  
xmlSW.Close()  
System.IO.StreamWriter xmlSW = new System.IO.StreamWriter("Customers.xml");  
custDS.WriteXml(xmlSW, XmlWriteMode.WriteSchema);  
xmlSW.Close();  

将列映射到 XML 元素、属性和文本

您可以指定如何在 XML 中表示表的列使用ColumnMapping的属性DataColumn对象。 下表显示了不同MappingType值为ColumnMapping的表列和生成的 XML 属性。

MappingType 值 描述
元素 这是默认设置。 列以元素名称为 ColumnName 的 XML 元素形式编写,列的内容以元素文本形式编写。 例如: <ColumnName>Column Contents</ColumnName>
特性 对于属性名称为 ColumnName 的当前行,列以 XML 元素的 XML 属性形式编写,列的内容以属性值形式编写。 例如: <RowElement ColumnName="Column Contents" />
SimpleContent 列的内容以 XML 元素中当前行文本的形式编写。 例如: <RowElement>Column Contents</RowElement> 请注意, SimpleContent不能设置为具有表的列元素列或嵌套的关系。
Hidden 不在 XML 输出中编写该列。

请参阅

历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 03/30/2017
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。