System.Web.UI.WebControls Namespace

---

Displays an XML document without formatting or using Extensible Stylesheet Language Transformations ( XSLT ).

Xml Class Members

Show Inherited Members

Constructors Visibility Constructor Parameters public Xml ( )   Properties Visibility Name Value Type Accessibility public ClientID String [ Get ] public Controls ControlCollection [ Get ] public Document XmlDocument [ Get , Set ] public DocumentContent String [ Get , Set ] public DocumentSource String [ Get , Set ] public EnableTheming Boolean [ Get , Set ] public SkinID String [ Get , Set ] public Transform XslTransform [ Get , Set ] public TransformArgumentList XsltArgumentList [ Get , Set ] public TransformSource String [ Get , Set ] public XPathNavigator XPathNavigator [ Get , Set ]   Methods Visibility Name Parameters Return Type protected AddParsedSubObject ( Object obj ) Void protected CreateControlCollection ( ) ControlCollection public FindControl ( String id ) Control public Focus ( ) Void protected GetDesignModeState ( ) IDictionary public HasControls ( ) Boolean

Use the Xml control to display the contents of an XML document without formatting or using XSL Transformations.

The XML document to display is specified by setting one of three properties. These three properties represent the different types of XML documents that can be displayed. You can display a System.Xml.XmlDocument, an XML string, or an XML file by setting the appropriate property. The following table lists the properties for specifying the XML document.

Property Description Document Sets the XML document using a System.Xml.XmlDocument object. DocumentContent Sets the XML document using a string. Note This property is commonly set declaratively by placing text between the opening and closing tags of the Xml control. DocumentSource Sets the XML document using a file. Note At least one of the XML document properties must be set to display an XML document. If more than one XML document property is set, the XML document referenced in the last property set is displayed. The documents in the other properties are ignored. You can optionally specify an XSL Transformation (XSLT) style sheet that formats the XML document before it is written to the output stream by setting one of two properties. The two properties represent the different types of XSL Transformation style sheets that can be used to format the XML document. You can format the XML document with a System.Xml.Xsl.XslCompiledTransform object or with an XSL Transformation style sheet file by setting the appropriate property. If no XSL Transformation style sheet is specified, the XML document is displayed using the default format. The following table lists the properties for specifying an XSL Transformation style sheet. Property Description Transform Formats the XML document using the specified System.Xml.Xsl.XslTransform object. TransformSource Formats the XML document using the specified XSL Transformation style sheet file. Note The XSL Transformation style sheet is optional. You do not need to set the Transform or the TransformSource property. If both XSL Transformation style sheet properties are set, the last property set determines which XSL Transformation style sheet is used to format the XML document. The other property is ignored. The Xml class also provides the TransformArgumentList property, which allows you to provide the XSL Transformation style sheet with optional arguments. The arguments can be either XSL Transformations (XSLT) parameters or extension objects.

For examples illustrating use of this control, see the individual member types of this class. For syntax information, see Xml in ASP.NET Syntax for Web Controls.

See Also

Xml Web Server Control

Suggested Reading