在 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,规范化链接,移除外部媒体和导航标记。
