This documentation is archived and is not being maintained.

Xml Class

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

Namespace:  System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)

[AspNetHostingPermissionAttribute(SecurityAction::LinkDemand, Level = AspNetHostingPermissionLevel::Minimal)]
[AspNetHostingPermissionAttribute(SecurityAction::InheritanceDemand, Level = AspNetHostingPermissionLevel::Minimal)]
public ref class Xml : public Control
<asp:Xml />

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.

NoteNote:

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

DocumentContent

Sets the XML document using a string.

NoteNote:

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

DocumentSource

Sets the XML document using a file.

NoteNote:

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.

NoteNote:

Using a System.Xml.Xsl::XslTransform object requires Full Trust permissions.

TransformSource

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

NoteNote:

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 enables you to provide the XSL Transformation style sheet with optional arguments. The arguments can be either XSL Transformations (XSLT) parameters or extension objects.

TopicLocation
How to: Add XML Web Server Controls to a Web Forms PageBuilding ASP .NET Web Applications
How to: Load XML Data in the XML Web Server ControlBuilding ASP .NET Web Applications
How to: Transform XML Data in the XML Web Server ControlBuilding ASP .NET Web Applications
How to: Load XML Data in the XML Web Server ControlBuilding ASP .NET Web Applications
How to: Transform XML Data in the XML Web Server ControlBuilding ASP .NET Web Applications
How to: Add XML Web Server Controls to a Web Forms Page (Visual Studio)Building ASP .NET Web Applications in Visual Studio
Walkthrough: Creating a Web Page to Display XML DataBuilding ASP .NET Web Applications in Visual Studio
Walkthrough: Displaying an XML Document in a Web Forms Page Using TransformationsBuilding ASP .NET Web Applications in Visual Studio

The following code example shows how to create XmlDocument and XslTransform objects from a sample XML file and an XSL Transformation style sheet. The objects are then used by the XML control to display the XML document.

No code example is currently available or this language may not be supported.

System::Object
  System.Web.UI::Control
    System.Web.UI.WebControls::Xml

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0
Show: