IHierarchicalDataSource Interfejs

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI
Zestaw:
System.Web.dll

Reprezentuje hierarchiczne źródło danych, z którymi hierarchiczne kontrolki powiązane z danymi, takie jak TreeView mogą być powiązane.

public interface class IHierarchicalDataSource
public interface IHierarchicalDataSource
type IHierarchicalDataSource = interface
Public Interface IHierarchicalDataSource
Pochodne

Przykłady

Poniższy przykład kodu pokazuje, jak rozszerzyć klasę abstrakcyjną HierarchicalDataSourceControl , która implementuje IHierarchicalDataSource interfejs, w celu utworzenia kontroli źródła danych, która wyświetla informacje o systemie plików. Klasa FileSystemDataSource udostępnia implementację GetHierarchicalView metody, która pobiera silnie typizowane obiekty widoku dla określonej ścieżki systemu plików. Ten przykład kodu jest częścią większego przykładu podanego HierarchicalDataSourceControl dla klasy.

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 kontroli, która umożliwia kontrolkom serwera sieci Web powiązanie z danymi i prezentowanie ich w spójny sposób. Kontrolki serwera sieci Web powiązane z danymi są nazywane kontrolkami powiązanymi z danymi, a klasy, które ułatwiają powiązanie, są nazywane kontrolkami źródła danych. Kontrolki źródła danych mogą reprezentować dowolne źródło danych: plik, strumień, relacyjna baza danych, obiekt biznesowy itd. Kontrolki źródła danych przedstawiają dane w spójny sposób na powiązane z danymi kontrolki niezależnie od źródła lub formatu danych bazowych.

Kontrolki źródła danych reprezentujące dane hierarchiczne pochodzące z HierarchicalDataSourceControl klasy, która jest podstawową ASP.NET implementacją interfejsuIHierarchicalDataSource. Interfejs IHierarchicalDataSource służy do definiowania kontrolek źródła danych, które uwidaczniają dane hierarchiczne, a nie dane tabelaryczne lub w stylu listy, do kontrolek serwera sieci Web, które pochodzą z HierarchicalDataBoundControl klasy, takiej jak kontrolka TreeView . Interfejs definiuje jedną metodę , GetHierarchicalViewktóra pobiera silnie typizowane HierarchicalDataSourceView obiekty. Kontrolki źródła danych, które implementują ten interfejs, obsługują widok hierarchiczny dla każdego reprezentowanego przez siebie poziomu hierarchicznego danych. Widoki źródła danych nie są nazwane, takie jak DataSourceView obiekty, ale są identyfikowane przez ich unikatową ścieżkę hierarchiczną, która jest viewPath parametrem przekazywanym GetHierarchicalView do metody.

Kontrolkę źródła danych można traktować jako kombinację obiektu i skojarzonych IHierarchicalDataSource z nim widoków danych bazowych. Każdy skojarzony HierarchicalDataSourceView obiekt definiuje możliwości kontroli źródła danych reprezentowanego na poziomie hierarchicznym i, podobnie jak wszystkie obiekty widoku źródła danych ASP.NET, wykonuje operacje, takie jak wstawianie, aktualizowanie, usuwanie i sortowanie.

Kontrolki źródła danych, które uwidaczniają tylko dane hierarchiczne, takie jak SiteMapDataSource, pochodzą z HierarchicalDataSourceControl klasy . Inne kontrolki źródła danych, które uwidaczniają swoje dane zarówno jako dane hierarchiczne, jak i dane tabelaryczne, takie jak XmlDataSource, pochodzą z HierarchicalDataSourceControl elementu , ale implementują IDataSource interfejsy i IListSource .

Metody

GetHierarchicalView(String)

Pobiera obiekt pomocnika widoku dla interfejsu IHierarchicalDataSource dla określonej ścieżki.

Zdarzenia

DataSourceChanged

Występuje, gdy magazyn danych reprezentowany IHierarchicalDataSource przez interfejs uległ zmianie.

Dotyczy

Zobacz też