System.Web 1.0.5000.0 2.0.0.0 Gtk# is thread aware, but not thread safe; See the <link location="node:gtk-sharp/programming/threads">Gtk# Thread Programming</link> for details. System.Web.UI.Control System.Web.UI.ControlBuilder(typeof(System.Web.UI.WebControls.XmlBuilder)) System.Web.UI.PersistChildren(true) System.ComponentModel.Designer("System.Web.UI.Design.WebControls.XmlDesigner, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", "System.ComponentModel.Design.IDesigner") System.ComponentModel.DefaultProperty("DocumentSource")

In this topic:

Introduction

Specifying XML Data

Specifying an XSL Transformation

Declarative Syntax

## Introduction

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

## Specifying XML Data

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 , 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

Sets the XML document using a object.

This property is obsolete. Use one of the other properties listed in this section to set the XML content for the control.

Sets the XML document using a string.

This property is commonly set declaratively by placing text between the opening and closing <asp:Xml> tags of the control.

Sets the XML document using a file.

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.

## Specifying an XSL Transformation

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 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

Formats the XML document using the specified object.

Using a object requires Full Trust permissions.

Formats the XML document using the specified XSL Transformation style sheet file.

The XSL Transformation style sheet is optional. You do not need to set the or the 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 class also provides the property, which enables you to provide the XSL Transformation style sheet with optional arguments. The arguments can be either XSL Transformations (XSLT) parameters or extension objects.

## Declarative Syntax

`<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" />`

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

- Constructor
  To be added

  Initializes a new instance of the class.

  1.0.5000.0
  2.0.0.0
- Method
  System.Void `` To be added To be added An that represents the to add. 1.0.5000.0 2.0.0.0
- Property
  1.0.5000.0
  2.0.0.0
  System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)
  System.String To be added. To be added.

  Overrides the property and returns the base server control identifier.

- Property
  1.0.5000.0
  2.0.0.0
  System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)
  System.Web.UI.ControlCollection To be added. To be added.

  Overrides the property and returns the base collection.

- Method
  2.0.0.0
  System.Web.UI.ControlCollection

  The method is used primarily by control developers extending the functionality of the control.

  Creates a new object.

  Always returns an .

- Property
  System.Xml.XmlDocument a

  The property is obsolete. To specify the XML that will be displayed in the control, use the property or the property. For more information about these alternatives, see the class overview for the control.

  The XML document to display in the control is specified in one of three ways. You can specify a object, an XML string, or an XML file by setting the appropriate property. The property is used to specify a (representing an XML document) to display in the control.

  Gets or sets the to display in the control.

  1.0.5000.0
  2.0.0.0
  System.Obsolete("Use the XPathNavigator property instead by creating an XPathDocument and calling CreateNavigator().")
  System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)
  System.ComponentModel.Browsable(false)
- Property
  System.String To be added: an object of type 'string'

  The XML document to display in the control is specified in one of three ways. You can specify a object, an XML string, or an XML file by setting the appropriate property. The property is used to specify an XML string (representing an XML document) to display in the control. The property is not typically programmatically set, or set as an attribute of the control. Instead, the XML string is usually set declaratively by placing text between the opening and closing <asp:Xml> tags of the control.

  Although the property contains both get and set accessors, only the set accessor is useful. If you use the get accessor, is returned.

  Sets a string that contains the XML document to display in the control.

  1.0.5000.0
  2.0.0.0
  System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)
  System.ComponentModel.Browsable(false)
- Property
  System.String To be added: an object of type 'string'

  The XML document to display in the control is specified in one of three ways. You can specify a object, an XML string, or an XML file by setting the appropriate property. The property is used to specify the path to an XML file (representing an XML document) to display in the control. You can use a relative or an absolute path. A relative path relates the location of the file to the location of the Web Forms page or user control, without specifying a complete path on the server. The path is relative to the location of the Web page. This makes it easier to move the entire site to another directory on the server without updating the path to the file in code. An absolute path provides the complete path, so moving the site to another directory requires updating the code.

  Gets or sets the path to an XML document to display in the control.

  1.0.5000.0
  2.0.0.0
  System.ComponentModel.Editor("System.Web.UI.Design.XmlUrlEditor, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", "System.Drawing.Design.UITypeEditor, System.Drawing, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")
  System.Web.UI.UrlProperty
  System.ComponentModel.DefaultValue("")
- Property
  2.0.0.0
  System.ComponentModel.DefaultValue(false)
  System.ComponentModel.Browsable(false)
  System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)
  System.Boolean To be added.

  The property is inherited from the class, but is not applicable to the class. Any attempt to set the value of this property throws a exception.

  Overrides the property. This property is not supported by the class.

- Method
  2.0.0.0
  System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)
  System.Web.UI.Control `` To be added.

  Searches the page naming container for the specified server control.

  The specified control; otherwise, null if the specified control does not exist.

  The identifier for the control to be found.
- Method
  2.0.0.0
  System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)
  System.Void

  The method is inherited from the class, but it is not applicable to the class. Any attempt to invoke the method throws a exception.

  Overrides the method. This method is not supported by the class.

- Method
  2.0.0.0
  System.Collections.IDictionary

  The method is a helper method used to get the current design-time state of the control.

  Gets design-time data for a control.

  An containing the design-time data for the control.

- Method
  2.0.0.0
  System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)
  System.Boolean To be added.

  Determines whether the server control contains any child controls.

  true if the control contains other controls; otherwise, false.

- Method
  System.Void `` To be added

  Renders the results to the output stream.

  The result of the output stream. 1.0.5000.0 2.0.0.0
- Property
  2.0.0.0
  System.ComponentModel.Browsable(false)
  System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)
  System.ComponentModel.DefaultValue("")
  System.String To be added.

  The property is inherited from the class, but is not applicable to the class. Any attempt to set the value of this property throws a exception.

  Overrides the property. This property is not supported by the class.

- Property
  System.Xml.Xsl.XslTransform a

  When using the control to display an XML document, you can optionally specify an Extensible Stylesheet Language Transformation (XSLT) style sheet that formats the XML document, before it is written to the output stream in one of two ways. You can format the XML document with either a object or an XSL Transformation style sheet file. If no XSL Transform document is specified, the XML document is displayed using the default format. The property is used to specify a object (representing an XSL Transform document) used to format the XML document before it is written to the output stream.

  Using a object requires Full Trust permissions.

  Gets or sets the object that formats the XML document before it is written to the output stream.

  1.0.5000.0
  2.0.0.0
  System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)
  System.ComponentModel.Browsable(false)
- Property
  System.Xml.Xsl.XsltArgumentList a

  Use the property to provide the XSL Transformation style sheet with optional arguments. The arguments can be either XSLT parameters or extension objects.

  For more information about using the class, see Xslt Argument List For Stylesheet Parameters Extension Objects.

  Gets or sets a that contains a list of optional arguments passed to the style sheet and used during the Extensible Stylesheet Language Transformation (XSLT).

  1.0.5000.0
  2.0.0.0
  System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)
  System.ComponentModel.Browsable(false)
- Property
  System.String To be added: an object of type 'string'

  When using the control to display an XML document, you can optionally specify an XSL Transformation style sheet that formats the XML document before it is written to the output stream in one of two ways. You can either format the XML document with a object or with an XSL Transformation style sheet file. If no XSL Transformation style sheet is specified, the XML document is displayed using the default format. The property is used to specify the path to an XSL Transformation style sheet file (representing an XSL Transformation style sheet) used to format the XML document before it is written to the output stream. You can use a relative or an absolute path. A relative path relates the location of the file to the location of the Web Forms page or user control, without specifying a complete path on the server. The path is relative to the location of the Web page. This makes it easier to move the entire site to another directory on the server without updating the path to the file in code. An absolute path provides the complete path, so moving the site to another directory requires updating the code.

  Gets or sets the path to an Extensible Stylesheet Language Transformation (XSLT) style sheet that formats the XML document before it is written to the output stream.

  1.0.5000.0
  2.0.0.0
  System.ComponentModel.Editor("System.Web.UI.Design.XslUrlEditor, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", "System.Drawing.Design.UITypeEditor, System.Drawing, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")
  System.ComponentModel.DefaultValue("")
- Property
  2.0.0.0
  System.ComponentModel.Browsable(false)
  System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)
  System.Xml.XPath.XPathNavigator To be added.

  This property can be used to associate an object with the control.

  An object is created from a class that implements the interface, such as the and classes. objects created by objects are read-only, and objects created by objects can be edited. An object's read-only or editable status is determined using the property of the class.

  Gets or sets a cursor model for navigating and editing the XML data associated with the control.