IHierarchicalDataSource Interface

  • Referência

Definição

Namespace:
System.Web.UI
Assembly:
System.Web.dll

Representa uma fonte de dados hierárquicos a que controles com associação de dados hierárquicos, como um TreeView, podem se associar.

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

Exemplos

O exemplo de código a seguir demonstra como estender a classe abstrata HierarchicalDataSourceControl , que implementa a IHierarchicalDataSource interface, para criar um controle de fonte de dados que exibe informações do sistema de arquivos. A FileSystemDataSource classe fornece uma implementação do GetHierarchicalView método, que recupera um objeto de exibição fortemente tipado para um caminho do sistema de arquivos especificado. 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

Comentários

ASP.NET dá suporte a uma arquitetura de associação de dados de controle que permite que os controles do servidor Web se associem aos dados e os apresentem de forma consistente. Os controles do servidor Web que se associam aos dados são chamados de controles associados a dados e as classes que facilitam a associação são chamadas de controles de fonte de dados. Os controles de fonte de dados podem representar qualquer fonte de dados: um arquivo, um fluxo, um banco de dados relacional, um objeto de negócios e assim por diante. Os controles de fonte de dados apresentam dados de maneira consistente para controles associados a dados, independentemente da origem ou formato dos dados subjacentes.

Os controles de fonte de dados que representam dados hierárquicos derivam da HierarchicalDataSourceControl classe, que é a implementação de ASP.NET base da IHierarchicalDataSource interface. A IHierarchicalDataSource interface é usada para definir controles de fonte de dados que expõem dados hierárquicos, em vez de dados tabulares ou estilo lista, a controles de servidor Web que derivam da HierarchicalDataBoundControl classe, como o TreeView controle. A interface define um único método, GetHierarchicalViewque recupera um objeto fortemente tipado HierarchicalDataSourceView . Os controles de fonte de dados que implementam essa interface dão suporte a uma exibição hierárquica para cada nível hierárquico de dados que eles representam. As exibições da fonte de dados não são nomeadas, como DataSourceView objetos, mas são identificadas por seu caminho hierárquico exclusivo, que é o viewPath parâmetro passado para o GetHierarchicalView método.

Você pode considerar um controle de fonte de dados como a combinação do IHierarchicalDataSource objeto e suas exibições associadas nos dados subjacentes. Cada objeto associado HierarchicalDataSourceView define os recursos de um controle de fonte de dados para o nível hierárquico representado e, como todos os objetos de exibição da fonte de dados ASP.NET, executa operações como inserir, atualizar, excluir e classificar.

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

Métodos

GetHierarchicalView(String)

Obtém o objeto auxiliar de exibição para a interface IHierarchicalDataSource para o caminho especificado.

Eventos

DataSourceChanged

Ocorre após uma alteração no armazenamento de dados representado pela interface IHierarchicalDataSource.

Aplica-se a

Confira também