日期:2008-03-06  浏览次数:20529 次

Aiyiweb.Com提示:XML 控件用于显示 XML 文档或 XSL 转换的结果。

阅读此文请先查看爱易网任务室的:ASP.NET入门教程:Web服务器控件,简单讲述了Web服务器控件的使用方法。

定义和用法

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

语法

<asp:Xml
    DocumentSource="uri"
    EnableTheming="True|False"
    EnableViewState="True|False"
    ID="string"
    OnDataBinding="DataBinding event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnUnload="Unload event handler"
    runat="server"
    SkinID="string"
    TransformSource="string"
    Visible="True|False"
/>

备注:使用 Xml 控件显示 XML 文档的内容或 XSL 转换的结果。

要显示的 XML 文档通过设置三个属性之一来指定。这三个属性表示可以显示的 XML 文档的不同类型。通过设置适当的属性,可以显示 XmlDocument、XML 字符串或 XML 文件。

留意:必须至少设置一个 XML 文档属性,否则将不会显示任何 XML 文档。如果设置了多个 XML 文档属性,则显示所设置的最后一个属性中的 XML 文档。其他属性中的文档将被忽略。

还可依据需求通过设置两个属性之一来指定 XSL 转换文档,该文档在将 XML 文档写入输出流之前对其进行格式化。这两个属性表示可用于格式化 XML 文档的 XSL 转换文档的不同类型。通过设置适当的属性,可以使用 XslTransform 或 XSL 转换文件格式化 XML 文档。如果未指定任何 XSL 转换文档,则使用默认格式显示 XML 文档。

留意:XSL 转换文档是可选的。不需求设置 Transform 或 TransformSource 属性。如果同时设置了两个 XSL 转换文档属性,则所设置的最后一个属性将确定使用哪个 XSL 转换文档格式化 XML 文档。另一个属性将被忽略。

Xml 类还提供了 TransformArgumentList 属性,您可以使用该属性为 XSL 转换提供可选参数。这些参数可以是 XSLT 参数或者是扩展对象。

<