IHierarchicalDataSource Интерфейс

Определение

Пространство имен:

System.Web.UI

Сборка:

System.Web.dll

Представляется источник иерархических данных, с которыми могут быть связаны элементы управления такие, как элемент TreeView.

public interface class IHierarchicalDataSource

public interface IHierarchicalDataSource

type IHierarchicalDataSource = interface

Public Interface IHierarchicalDataSource

Производный

System.Web.UI.HierarchicalDataSourceControl

Примеры

В следующем примере кода показано, как расширить абстрактный HierarchicalDataSourceControl класс, реализующий интерфейс, для создания элемента управления источником данных, отображающего IHierarchicalDataSource сведения о файловой системе. Класс FileSystemDataSource предоставляет реализацию GetHierarchicalView метода, который извлекает строго типизированный объект представления для указанного пути к файловой системе. Этот пример кода является частью более крупного примера, предоставленного HierarchicalDataSourceControl для класса.

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

Комментарии

ASP.NET поддерживает архитектуру привязки данных элемента управления, которая позволяет элементам управления веб-сервера связываться с данными и представлять их согласованно. Элементы управления веб-сервера, которые привязываются к данным, называются элементами управления с привязкой к данным, а классы, упрощающие привязку, называются элементами управления источником данных. Элементы управления источником данных могут представлять любой источник данных: файл, поток, реляционная база данных, бизнес-объект и т. д. Элементы управления источником данных представляют данные согласованно для элементов управления, привязанных к данным, независимо от источника или формата базовых данных.

Элементы управления источником данных, представляющие иерархические данные, являются производными от HierarchicalDataSourceControl класса, который является базовой ASP.NET реализации IHierarchicalDataSource интерфейса. Интерфейс IHierarchicalDataSource используется для определения элементов управления источником данных, которые предоставляют иерархические данные, а не табличные или данные в стиле списка, для элементов управления веб-сервера, производных от HierarchicalDataBoundControl класса, таких как TreeView элемент управления. Интерфейс определяет один метод, GetHierarchicalViewкоторый получает строго типизированный HierarchicalDataSourceView объект. Элементы управления источником данных, реализующие этот интерфейс, поддерживают иерархическое представление для каждого иерархического уровня данных, которые они представляют. Представления источников данных не именуются, например DataSourceView объекты, но идентифицируются по их уникальному иерархическому пути, который является параметром viewPath , передаваемым методу GetHierarchicalView .

Элемент управления источником данных можно рассматривать как сочетание IHierarchicalDataSource объекта и связанных с ним представлений базовых данных. Каждый связанный HierarchicalDataSourceView объект определяет возможности элемента управления источниками данных для представленного иерархического уровня, и, как и все объекты представления источников данных ASP.NET, выполняют такие операции, как вставка, обновление, удаление и сортировка.

Элементы управления источником данных, предоставляющие только иерархические данные, например SiteMapDataSource, являются производными от HierarchicalDataSourceControl класса. Другие элементы управления источником данных, предоставляющие их данные как иерархические, так и табличные данные, например XmlDataSource, являются производными, HierarchicalDataSourceControl но реализуют IDataSource и IListSource интерфейсы.

Методы

GetHierarchicalView(String)

Возвращает объект помощника представления интерфейса IHierarchicalDataSource для указанного пути.

События

DataSourceChanged

Происходит, если изменено хранилище данных, которое представляет интерфейс IHierarchicalDataSource.

См. также раздел

• HierarchicalDataSourceControl
• HierarchicalDataSourceView
• HierarchicalDataBoundControl
• IDataSource
• SiteMapDataSource
• XmlDataSource