IHierarchicalDataSource Интерфейс

Определение

Представляется источник иерархических данных, с которыми могут быть связаны элементы управления такие, как элемент TreeView.Represents a hierarchical data source that hierarchical data-bound controls such as TreeView can bind to.

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

Примеры

В следующем примере кода показано, как расширить абстрактный HierarchicalDataSourceControl класс, который IHierarchicalDataSource реализует интерфейс, для создания элемента управления источника данных, отображающего сведения о файловой системе.The following code example demonstrates how to extend the abstract HierarchicalDataSourceControl class, which implements the IHierarchicalDataSource interface, to create a data source control that displays file system information. Класс предоставляет реализацию GetHierarchicalView метода, который получает объект представления со строгой типизацией для указанного пути файловой системы. FileSystemDataSourceThe FileSystemDataSource class provides an implementation of the GetHierarchicalView method, which retrieves a strongly typed view object for a specified file system path. Этот пример кода является частью большого примера, HierarchicalDataSourceControl приведенного для класса.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

Комментарии

ASP.NET поддерживает архитектуру привязки данных элемента управления, которая позволяет серверным веб-элементам управления выполнять привязку к данным и представлять их единообразно.ASP.NET supports a control data-binding architecture that enables Web server controls to bind to data and present it in a consistent fashion. Веб-серверные элементы управления, привязанные к данным, называются элементами управления с привязкой к данным, а классы, упрощающие привязку, называются элементами управления источниками данных.Web server controls that bind to data are called data-bound controls, and the classes that facilitate binding are called data source controls. Элементы управления источниками данных могут представлять любой источник данных: файл, поток, реляционную базу данных, бизнес-объект и т. д.Data source controls can represent any data source: a file, a stream, a relational database, a business object, and so on. Элементы управления источниками данных представляют данные единообразно для элементов управления, привязанных к данным, независимо от источника или формата базовых данных.Data source controls present data in a consistent way to data-bound controls, regardless of the source or format of the underlying data.

Элементы управления источниками данных, представляющие иерархические данные HierarchicalDataSourceControl , являются производными от класса, который является базовой IHierarchicalDataSource реализацией интерфейса ASP.NET.Data source controls that represent hierarchical data derive from the HierarchicalDataSourceControl class, which is the base ASP.NET implementation of the IHierarchicalDataSource interface. Интерфейс используется для определения элементов управления источниками данных, которые предоставляют иерархические данные, а не данные из табличных или списков, для серверных веб-элементов управления HierarchicalDataBoundControl , производных от TreeView класса, таких как элемент управления. IHierarchicalDataSourceThe IHierarchicalDataSource interface is used to define data source controls that expose hierarchical data, rather than tabular or list-style data, to Web server controls that derive from the HierarchicalDataBoundControl class, such as the TreeView control. Интерфейс определяет один метод, GetHierarchicalViewкоторый извлекает строго типизированный HierarchicalDataSourceView объект.The interface defines a single method, GetHierarchicalView, which retrieves a strongly typed HierarchicalDataSourceView object. Элементы управления источниками данных, реализующие этот интерфейс, поддерживают иерархическое представление для каждого иерархического уровня данных, которые они представляют.Data source controls that implement this interface support a hierarchical view for each hierarchical level of data they represent. Представления источников данных не именуются, как DataSourceView и объекты, но идентифицируются по их уникальному иерархическому пути, который viewPath является параметром, передаваемым GetHierarchicalView в метод.The data source views are not named, like DataSourceView objects, but are identified by their unique hierarchical path, which is the viewPath parameter passed to the GetHierarchicalView method.

Элемент управления источниками данных можно представить как сочетание IHierarchicalDataSource объекта и связанных с ним представлений базовых данных.You can think of a data source control as the combination of the IHierarchicalDataSource object and its associated views on the underlying data. Каждый связанный HierarchicalDataSourceView объект определяет возможности элемента управления источника данных для представленного иерархического уровня, и, как и все объекты представления источников данных ASP.NET, выполняет такие операции, как INSERT, Update, DELETE и Sort.Each associated HierarchicalDataSourceView object defines the capabilities of a data source control for the hierarchical level represented, and, like all ASP.NET data source view objects, performs operations such as insert, update, delete, and sort.

Элементы управления источниками данных, которые предоставляют только иерархические SiteMapDataSourceданные, такие как, HierarchicalDataSourceControl являются производными от класса.Data source controls that expose only hierarchical data, such as SiteMapDataSource, are derived from the HierarchicalDataSourceControl class. Другие элементы управления источниками данных, которые предоставляют свои данные в виде иерархических данных и табличных данных, XmlDataSourceнапример HierarchicalDataSourceControl , являются производными IListSource от, но реализуют IDataSource интерфейсы и.Other data source controls that expose their data as both hierarchical data and tabular data, such as XmlDataSource, are derived from HierarchicalDataSourceControl but implement the IDataSource and IListSource interfaces.

Методы

GetHierarchicalView(String)

Возвращает объект помощника представления интерфейса IHierarchicalDataSource для указанного пути.Gets the view helper object for the IHierarchicalDataSource interface for the specified path.

События

DataSourceChanged

Происходит, если изменено хранилище данных, которое представляет интерфейс IHierarchicalDataSource.Occurs when the data storage that the IHierarchicalDataSource interface represents has changed.

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

Дополнительно