IHierarchicalDataSource Rozhraní

Definice

Představuje hierarchický zdroj dat, ke kterému hierarchické ovládací prvky vázané na data, jako TreeView je například možné vytvořit vazbu.

public interface class IHierarchicalDataSource
public interface IHierarchicalDataSource
type IHierarchicalDataSource = interface
Public Interface IHierarchicalDataSource
Odvozené

Příklady

Následující příklad kódu ukazuje, jak rozšířit abstraktní HierarchicalDataSourceControl třídu, která implementuje IHierarchicalDataSource rozhraní, vytvořit ovládací prvek zdroje dat, který zobrazuje informace o systému souborů. FileSystemDataSource Třída poskytuje implementaci GetHierarchicalView metody, která načte objekt zobrazení silného typu pro zadanou cestu systému souborů. Tento příklad kódu je součástí většího příkladu uvedeného pro třídu 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

Poznámky

ASP.NET podporuje architekturu řídicích datových vazeb, která umožňuje ovládacím prvkům webového serveru svázat data a prezentovat je konzistentním způsobem. Ovládací prvky webového serveru, které se sváže s daty, se nazývají ovládací prvky vázané na data a třídy, které usnadňují vazbu, se nazývají ovládací prvky zdroje dat. Ovládací prvky zdroje dat mohou představovat libovolný zdroj dat: soubor, datový proud, relační databázi, obchodní objekt atd. Ovládací prvky zdroje dat představují data konzistentním způsobem pro ovládací prvky vázané na data bez ohledu na zdroj nebo formát podkladových dat.

Ovládací prvky zdroje dat, které představují hierarchická data odvozená z třídy HierarchicalDataSourceControl, což je základní ASP.NET implementace rozhraní IHierarchicalDataSource. Rozhraní IHierarchicalDataSource slouží k definování ovládacích prvků zdroje dat, které zpřístupňují hierarchická data místo tabulkových nebo listových dat pro ovládací prvky webového HierarchicalDataBoundControl serveru odvozené od třídy, jako TreeView je například ovládací prvek. Rozhraní definuje jednu metodu, GetHierarchicalViewkterá načte objekt silného typu HierarchicalDataSourceView . Ovládací prvky zdroje dat, které toto rozhraní implementují, podporují hierarchické zobrazení pro každou hierarchickou úroveň dat, která představují. Zobrazení zdroje dat nejsou pojmenována, jako DataSourceView jsou objekty, ale jsou identifikovány jejich jedinečnou hierarchickou cestou, což je viewPath parametr předaný GetHierarchicalView metodě.

Ovládací prvek zdroje dat si můžete představit jako kombinaci objektu IHierarchicalDataSource a jeho přidružených zobrazení na podkladových datech. Každý přidružený objekt HierarchicalDataSourceView definuje možnosti ovládacího prvku zdroje dat pro reprezentovanou hierarchickou úroveň a podobně jako všechny ASP.NET objekty zobrazení zdroje dat provádí operace, jako jsou vložení, aktualizace, odstranění a řazení.

Ovládací prvky zdroje dat, které zpřístupňují pouze hierarchická data, například SiteMapDataSource, jsou odvozeny z HierarchicalDataSourceControl třídy. Jiné ovládací prvky zdroje dat, které zpřístupňují jejich data jako hierarchická i tabulková data, jako jsou například XmlDataSource, jsou odvozeny z HierarchicalDataSourceControl těchto dat, ale implementují rozhraníIDataSource.IListSource

Metody

Name Description
GetHierarchicalView(String)

Získá pomocný objekt zobrazení pro IHierarchicalDataSource rozhraní pro zadanou cestu.

Událost

Name Description
DataSourceChanged

Nastane, když se změnilo úložiště dat, které IHierarchicalDataSource rozhraní představuje.

Platí pro

Viz také