IHierarchicalDataSource Interfejs

Definicja

Reprezentuje hierarchiczne źródło danych, które zawiera hierarchiczne kontrolki powiązane z danymi, takie jak TreeView można powiązać z.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
Pochodne

Przykłady

Poniższy przykład kodu demonstruje, jak zwiększyć klasę abstrakcyjną HierarchicalDataSourceControl , która implementuje IHierarchicalDataSource interfejs, aby utworzyć kontrolkę źródła danych, która wyświetla informacje o systemie plików.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. FileSystemDataSourceKlasa zawiera implementację GetHierarchicalView metody, która pobiera obiekt widoku o jednoznacznie określonym typie dla określonej ścieżki systemu plików.The FileSystemDataSource class provides an implementation of the GetHierarchicalView method, which retrieves a strongly typed view object for a specified file system path. Ten przykład kodu jest częścią większego przykładu dostarczonego dla HierarchicalDataSourceControl klasy.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

Uwagi

ASP.NET obsługuje architekturę powiązania danych formantu, która umożliwia kontrolom serwera sieci Web powiązanie z danymi i prezentowanie ich w spójny sposób.ASP.NET supports a control data-binding architecture that enables Web server controls to bind to data and present it in a consistent fashion. Kontrolki serwera sieci Web, które wiążą się z danymi, są nazywane kontrolkami związanymi z danymi, a klasy, które ułatwiają powiązanie, są nazywane kontrolkami źródła danych.Web server controls that bind to data are called data-bound controls, and the classes that facilitate binding are called data source controls. Kontrolki źródła danych mogą reprezentować dowolne źródło danych: plik, strumień, relacyjną bazę danych, obiekt biznesowy itd.Data source controls can represent any data source: a file, a stream, a relational database, a business object, and so on. Kontrolki źródła danych przedstawiają dane w spójny sposób z kontrolkami związanymi z danymi, niezależnie od źródła lub formatu danych źródłowych.Data source controls present data in a consistent way to data-bound controls, regardless of the source or format of the underlying data.

Kontrolki źródła danych, które reprezentują dane hierarchiczne HierarchicalDataSourceControl , pochodzą z klasy, która jest podstawową implementacją ASP.NET IHierarchicalDataSource interfejsu.Data source controls that represent hierarchical data derive from the HierarchicalDataSourceControl class, which is the base ASP.NET implementation of the IHierarchicalDataSource interface. IHierarchicalDataSourceInterfejs jest używany do definiowania formantów źródła danych, które uwidaczniają dane hierarchiczne, a nie tabelaryczne lub dane stylu listy, do kontrolek serwera sieci Web, które pochodzą z HierarchicalDataBoundControl klasy, takiej jak TreeView kontrolka.The 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. Interfejs definiuje pojedynczą metodę, GetHierarchicalView która pobiera silnie wpisaną HierarchicalDataSourceView obiekt.The interface defines a single method, GetHierarchicalView, which retrieves a strongly typed HierarchicalDataSourceView object. Kontrolki źródła danych implementujące ten interfejs obsługują widok hierarchiczny dla każdego poziomu hierarchicznego danych, które reprezentują.Data source controls that implement this interface support a hierarchical view for each hierarchical level of data they represent. Widoki źródła danych nie są nazwami, takimi jak DataSourceView obiekty, ale są identyfikowane przez ich unikatową ścieżkę hierarchiczną, która jest viewPath parametrem przesłanym do GetHierarchicalView metody.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.

Kontrolkę źródła danych można traktować jako kombinację IHierarchicalDataSource obiektu i skojarzonych z nim widoków danych źródłowych.You can think of a data source control as the combination of the IHierarchicalDataSource object and its associated views on the underlying data. Każdy skojarzony HierarchicalDataSourceView obiekt definiuje możliwości kontroli źródła danych dla reprezentowanego poziomu hierarchicznego oraz, podobnie jak wszystkie obiekty widoku źródła danych ASP.NET, wykonuje operacje, takie jak INSERT, Update, DELETE i 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.

Kontrolki źródła danych, które uwidaczniają tylko dane hierarchiczne, takie jak SiteMapDataSource , są wyprowadzane z HierarchicalDataSourceControl klasy.Data source controls that expose only hierarchical data, such as SiteMapDataSource, are derived from the HierarchicalDataSourceControl class. Inne kontrolki źródła danych, które uwidaczniają dane zarówno jako dane hierarchiczne, jak i dane tabelaryczne, takie jak XmlDataSource , są wyprowadzane z, HierarchicalDataSourceControl ale implementują IDataSource IListSource interfejsy i.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.

Metody

GetHierarchicalView(String)

Pobiera obiekt pomocnika widoku dla IHierarchicalDataSource interfejsu dla określonej ścieżki.Gets the view helper object for the IHierarchicalDataSource interface for the specified path.

Zdarzenia

DataSourceChanged

Występuje, gdy magazyn danych, który IHierarchicalDataSource reprezentuje interfejs, został zmieniony.Occurs when the data storage that the IHierarchicalDataSource interface represents has changed.

Dotyczy

Zobacz też