ASP.NET XML 控件
定义和用法
XML 控件用于显示 XML 文档或 XSL 转换的结果。
属性
通过设置 Document、DocumentContent 或 DocumentSource 这三个属性之一来指定要显示的 XML 文档。这三个属性表示可以显示的不同类型的 XML 文档。通过设置适当的属性,可以显示 System.Xml.XmlDocument、XML 字符串或 XML 文件。
通过设置 Transform、TransformSource 这两个属性之一,可以选择指定 XSL 转换 (XSLT) 样式表,该样式表在 XML 文档被写入输出流之前对其进行格式化。这两个属性表示可用于格式化 XML 文档的不同类型的 XSL 转换样式表。通过设置适当的属性,可以用 System.Xml.Xsl.XslCompiledTransform 对象或 XSL 转换样式表文件来格式化 XML 文档。如果未指定 XSL 转换样式表,则使用默认格式显示 XML 文档。
Xml 类还提供 TransformArgumentList 属性,该属性使您得以提供具有可选参数的 XSL 转换样式表。这些参数可以是 XSL 转换 (XSLT) 参数或扩展对象。
属性 | 描述 | .NET |
---|---|---|
Document | 不赞成使用。规定使用 System.Xml.XmlDocument 对象的 XML 文档。 | 1.0 |
DocumentContent | 规定 XML 字符串。 | 1.0 |
DocumentSource | 规定在 Xml 控件中显示的 XML 文档的路径。 | 1.0 |
runat | 规定该控件是服务器控件。必须设置为 "server"。 | 1.0 |
Transform | 使用 System.Xml.Xsl.XslTransform 对象来格式化 XML 文档。 | 1.0 |
TransformArgumentList | 包含传递给样式表并在扩展样式表语言转换 (XSLT) 中使用的可选参数列表。 | |
TransformSource | 规定 XSL 转换文件的路径。 | |
XPathNavigator | 用于导航和编辑与 Xml 控件关联的 XML 数据的光标模型。 |
控件标准属性
- AppRelativeTemplateSourceDirectory, BindingContainer, ClientID, Controls,
- EnableTheming, EnableViewState, ID, NamingContainer, Page, Parent, Site,
- TemplateControl, TemplateSourceDirectory, UniqueID, Visible
如需完整描述,请访问控件标准属性。
实例
XML
本例展示了如何使用 XML 控件来显示 XSL 转换的结果。
<html>
<body>
<form runat="server">
<asp:Xml DocumentSource="cdcatalog.xml" TransformSource="cdcatalog.xsl" runat="server" />
</form>
<p><a href="cdcatalog.xml" target="_blank">查看 XML 文件</a></p>
<p><a href="cdcatalog.xsl" target="_blank">查看 XSL 文件</a></p>
</body>
</html>