IHierarchicalDataSource 介面

  • 參考

定義

命名空間:
System.Web.UI
組件:
System.Web.dll

表示階層式資料繫結控制項 (例如 TreeView) 可以繫結至的階層式資料來源。

public interface class IHierarchicalDataSource
public interface IHierarchicalDataSource
type IHierarchicalDataSource = interface
Public Interface IHierarchicalDataSource
衍生

範例

下列程式碼範例示範如何擴充實作 介面的 IHierarchicalDataSource 抽象 HierarchicalDataSourceControl 類，以建立顯示檔案系統資訊的資料來源控制項。 類別 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 支援控制項資料系結架構，讓 Web 服務器控制項能夠系結至資料，並以一致的方式呈現它。 系結至資料的 Web 服務器控制項稱為資料系結控制項，而有助於系結的類別稱為資料來源控制項。 資料來源控制項可以代表任何資料來源：檔案、資料流程、關係資料庫、商務物件等等。 不論基礎資料的來源或格式為何，資料來源控制項都會以一致的方式呈現資料系結控制項。

代表階層式資料的資料來源控制項衍生自 HierarchicalDataSourceControl 類別，這是介面的 IHierarchicalDataSource 基底 ASP.NET 實作。 IHierarchicalDataSource介面可用來定義資料來源控制項，這些控制項會公開階層式資料，而不是表格式或清單樣式資料給衍生自 HierarchicalDataBoundControl 類別的 Web 服務器控制項，例如 TreeView 控制項。 介面會定義單一方法， GetHierarchicalView 這個方法會擷取強型別 HierarchicalDataSourceView 物件。 實作此介面的資料來源控制項支援其所代表之每個階層式資料層級的階層式檢視。 資料來源檢視不會命名，例如 DataSourceView 物件，但是由其唯一階層式路徑所識別，這是 viewPath 傳遞至 方法的參數 GetHierarchicalView 。

您可以將資料來源控制項視為物件及其基礎資料相關檢視的組合 IHierarchicalDataSource 。 每個相關聯的 HierarchicalDataSourceView 物件都會定義所表示階層式層級的資料來源控制項功能，而且就像所有 ASP.NET 資料來源檢視物件一樣，都會執行插入、更新、刪除和排序等作業。

只公開階層式資料的資料來源控制項，例如 SiteMapDataSource 衍生自 HierarchicalDataSourceControl 類別。 其他公開其資料做為階層式資料和表格式資料的資料來源控制項，例如 XmlDataSource 衍生自 HierarchicalDataSourceControl ，但實作 IDataSource 和 IListSource 介面。

方法

GetHierarchicalView(String)

為指定之路徑的 IHierarchicalDataSource 介面，取得檢視 Helper 物件。

事件

DataSourceChanged

當 IHierarchicalDataSource 介面所表示的資料儲存體已變更時發生。

適用於

另請參閱