IHierarchicalDataSource Интерфейс

Определение

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

public interface class IHierarchicalDataSource
public interface IHierarchicalDataSource
type IHierarchicalDataSource = interface
Public Interface IHierarchicalDataSource
Производный

Примеры

В следующем примере кода показано, как расширить абстрактный 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 интерфейс.

Применяется к

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