IHierarchicalDataSource.GetHierarchicalView(String) Method

Reference

Definition

Namespace:: System.Web.UI

Assembly:: System.Web.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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

public:
 System::Web::UI::HierarchicalDataSourceView ^ GetHierarchicalView(System::String ^ viewPath);

public System.Web.UI.HierarchicalDataSourceView GetHierarchicalView (string viewPath);

abstract member GetHierarchicalView : string -> System.Web.UI.HierarchicalDataSourceView

Public Function GetHierarchicalView (viewPath As String) As HierarchicalDataSourceView

Parameters

viewPath: String

The hierarchical path of the view to retrieve.

Returns

HierarchicalDataSourceView

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

Examples

The following code example demonstrates how to override the GetHierarchicalView method in a class that extends the HierarchicalDataSourceControl class to retrieve a strongly typed HierarchicalDataSourceView object for a unique hierarchical path. The FileSystemDataSource class's implementation of GetHierarchicalView retrieves a FileSystemDataSourceView object for a specified file system path. 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;

public class FileSystemDataSource :
    HierarchicalDataSourceControl, IHierarchicalDataSource
{
    private FileSystemDataSourceView view = null;

    public FileSystemDataSource() : base() { }

    protected override HierarchicalDataSourceView
        GetHierarchicalView(string viewPath)
    {
        view = new FileSystemDataSourceView(viewPath);
        return view;
    }
}

Imports System.Collections
Imports System.IO
Imports System.Runtime.InteropServices
Imports System.Security.Permissions
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls

Namespace Samples.AspNet

    Public Class FileSystemDataSource
        Inherits HierarchicalDataSourceControl

        Public Sub New()
        End Sub

        Private view As FileSystemDataSourceView = Nothing

        Protected Overrides Function GetHierarchicalView( _
            ByVal viewPath As String) As HierarchicalDataSourceView

            view = New FileSystemDataSourceView(viewPath)
            Return view
        End Function

    End Class

Remarks

The IHierarchicalDataSource interface, like the IDataSource interface, defines a method that hierarchical data source controls use to retrieve a data source view. Like all DataSourceView helper objects that are associated with data source controls, a HierarchicalDataSourceView object defines the operations that the data source can perform with the underlying data. However, although data source controls that represent tabular data typically have only one named view, hierarchical data source controls support a view for each level of hierarchical data that the data source control represents. The level of hierarchical data is identified by a unique hierarchical path, passed as the viewPath parameter.

Applies to

Partager via