This documentation is archived and is not being maintained.

XmlHierarchicalDataSourceView Class

Represents a data view on an XML node or collection of XML nodes for an XmlDataSource control.


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

public class XmlHierarchicalDataSourceView : HierarchicalDataSourceView

The XmlHierarchicalDataSourceView type exposes the following members.

Public methodEquals(Object)Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
Protected methodFinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public methodGetHashCodeServes as a hash function for a particular type. (Inherited from Object.)
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Protected methodMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodSelectGets a list of the data items from the underlying data source. (Overrides HierarchicalDataSourceView.Select().)
Public methodToStringReturns a string that represents the current object. (Inherited from Object.)

The XmlDataSource control can present its underlying data in both tabular and hierarchical format to Web server controls that bind to it. Controls such as GridView or DropDownList use the XmlDataSource to bind to XML data and present it in list or tabular form, while controls that derive from the HierarchicalDataBoundControl class, such as TreeView, bind to XML data and present it in hierarchical form.

The XmlDataSource creates each view type internally through different code paths. If the GetView method is called on the XmlDataSource control, an XmlDataSourceView object is created by the XmlDataSource control. If the GetHierarchicalView method is called, an XmlHierarchicalDataSourceView object is created. The XmlDataSourceView class is provided for Web server controls that derive from DataBoundControl and bind to lists and tabular data, while the XmlHierarchicalDataSourceView is provided for Web server controls that derive from HierarchicalDataBoundControl and bind to hierarchical data. Internally, the DataBoundControl and CompositeDataBoundControl classes call the Select method of XmlDataSourceView object view to retrieve data from a data source, while a class derived from HierarchicalDataBoundControl calls the Select method.

Like all HierarchicalDataSourceView helper objects, the XmlHierarchicalDataSourceView defines the operations that the data source can perform with the underlying data. Because the XmlHierarchicalDataSourceView class only overrides the Select method, the associated XmlDataSource control does not support sort expressions or execute, delete, or update operations.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

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

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