IHierarchicalDataSource Interface

Definição

Espaço de Nomes:
System.Web.UI
Assemblagem:
System.Web.dll

Representa uma fonte de dados hierárquica à qual controla dados encadernados hierárquicos, como pode TreeView ligar-se.

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

Exemplos

O exemplo de código seguinte demonstra como estender a classe abstrata HierarchicalDataSourceControl , que implementa a IHierarchicalDataSource interface, para criar um controlo de fonte de dados que exibe informação do sistema de ficheiros. A FileSystemDataSource classe fornece uma implementação do GetHierarchicalView método, que recupera um objeto de visualização fortemente tipado para um caminho específico do sistema de ficheiros. Este exemplo de código faz parte de um exemplo maior fornecido para a HierarchicalDataSourceControl classe.

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

Observações

O ASP.NET suporta uma arquitetura de ligação de dados de controlo que permite que os controlos do servidor Web se associem aos dados e os apresentem de forma consistente. Os controlos de servidor web que se ligam aos dados são chamados controlos de ligação de dados, e as classes que facilitam a ligação são chamadas controlos de fonte de dados. Os controlos de fonte de dados podem representar qualquer fonte de dados: um ficheiro, um fluxo, uma base de dados relacional, um objeto de negócio, e assim por diante. Os controlos de fonte de dados apresentam dados de forma consistente aos controlos ligados aos dados, independentemente da origem ou formato dos dados subjacentes.

Os controlos de fonte de dados que representam dados hierárquicos derivam da classe HierarchicalDataSourceControl, que é a implementação base ASP.NET da interface IHierarchicalDataSource. A IHierarchicalDataSource interface é usada para definir controlos de fonte de dados que expõem dados hierárquicos, em vez de dados tabulares ou em lista, a controlos de servidor Web derivados da HierarchicalDataBoundControl classe, como o TreeView controlo. A interface define um único método, GetHierarchicalView, que recupera um objeto fortemente tipado HierarchicalDataSourceView . Os controlos de fonte de dados que implementam esta interface suportam uma visão hierárquica para cada nível hierárquico de dados que representam. As vistas da fonte de dados não são nomeadas, tal como DataSourceView os objetos, mas são identificadas pelo seu caminho hierárquico único, que é o viewPath parâmetro passado ao GetHierarchicalView método.

Pode pensar num controlo de fonte de dados como a combinação do IHierarchicalDataSource objeto e das suas perspetivas associadas sobre os dados subjacentes. Cada objeto associado HierarchicalDataSourceView define as capacidades de um controlo de fonte de dados para o nível hierárquico representado e, como todos os objetos ASP.NET vista da fonte de dados, executa operações como inserir, atualizar, eliminar e ordenar.

Os controlos de fonte de dados que expõem apenas dados hierárquicos, como SiteMapDataSource, são derivados da HierarchicalDataSourceControl classe. Outros controlos de fonte de dados que expõem os seus dados tanto como dados hierárquicos como dados tabulares, como XmlDataSource, são derivados de HierarchicalDataSourceControl mas implementam as IDataSource interfaces and IListSource .

Métodos

Name Description
GetHierarchicalView(String)

Obtém o objeto assistente de vista para a IHierarchicalDataSource interface do caminho especificado.

evento

Name Description
DataSourceChanged

Ocorre quando o armazenamento de dados que a IHierarchicalDataSource interface representa mudou.

Aplica-se a

Ver também