This documentation is archived and is not being maintained.

HierarchicalDataSourceControl.GetHierarchicalView Method

Gets the view helper object for the IHierarchicalDataSource interface for the specified path.

Namespace: System.Web.UI
Assembly: System.Web (in system.web.dll)

protected abstract HierarchicalDataSourceView GetHierarchicalView (
	string viewPath
protected abstract HierarchicalDataSourceView GetHierarchicalView (
	String viewPath
protected abstract function GetHierarchicalView (
	viewPath : String
) : HierarchicalDataSourceView
Not applicable.



The hierarchical path of the view to retrieve.

Return Value

A HierarchicalDataSourceView that represents a single view of the data at the hierarchical level identified by the viewPath parameter.

This GetHierarchicalView method provides the default implementation for the HierarchicalDataSourceControl class, which simply returns a null reference (Nothing in Visual Basic). Classes that derive from the HierarchicalDataSourceControl class override this method and provide an implementation to return a strongly typed view that derives from HierarchicalDataSourceView.

The following code example demonstrates how to override the GetHierarchicalView method in a class that extends the HierarchicalDataSourceControl class to return a strongly typed HierarchicalDataSourceView object. This code example is part of a larger example provided for the HierarchicalDataSourceControl class.

using System;
using System.Collections;
using System.IO;
using System.Runtime.InteropServices;
using System.Security.Permissions;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;

[AspNetHostingPermission(SecurityAction.Demand, Level=AspNetHostingPermissionLevel.Minimal)]
public class FileSystemDataSource : HierarchicalDataSourceControl, IHierarchicalDataSource
    public FileSystemDataSource() : base() {}

    // Return a strongly typed view for the current data source control.
    private FileSystemDataSourceView view = null;
    protected override HierarchicalDataSourceView GetHierarchicalView(string viewPath) {
        if (null == view) {
            view = new FileSystemDataSourceView(viewPath);
        return view;

    // The FileSystemDataSource can be used declaratively. To enable
    // declarative use, override the default implementation of
    // CreateControlCollection to return a ControlCollection that
    // you can add to.
    protected override ControlCollection CreateControlCollection() {
        return new ControlCollection(this);

Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0