IHierarchicalDataSource Interfaz

  • Referencia

Definición

Espacio de nombres:
System.Web.UI
Ensamblado:
System.Web.dll

Representa un origen de datos jerárquico al que se pueden enlazar controles enlazados a datos jerárquicos como TreeView.

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

Ejemplos

En el ejemplo de código siguiente se muestra cómo extender la clase abstracta HierarchicalDataSourceControl , que implementa la IHierarchicalDataSource interfaz , para crear un control de origen de datos que muestre información del sistema de archivos. La FileSystemDataSource clase proporciona una implementación del GetHierarchicalView método , que recupera un objeto de vista fuertemente tipado para una ruta de acceso del sistema de archivos especificada. Este ejemplo de código forma parte de un ejemplo más grande proporcionado para la HierarchicalDataSourceControl clase .

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

Comentarios

ASP.NET admite una arquitectura de enlace de datos de control que permite a los controles de servidor web enlazar a datos y presentarlos de forma coherente. Los controles de servidor web que se enlazan a datos se denominan controles enlazados a datos y las clases que facilitan el enlace se denominan controles de origen de datos. Los controles de origen de datos pueden representar cualquier origen de datos: un archivo, una secuencia, una base de datos relacional, un objeto de negocio, etc. Los controles de origen de datos presentan datos de forma coherente a los controles enlazados a datos, independientemente del origen o formato de los datos subyacentes.

Los controles de origen de datos que representan datos jerárquicos derivan de la HierarchicalDataSourceControl clase , que es la implementación base ASP.NET de la IHierarchicalDataSource interfaz. La IHierarchicalDataSource interfaz se usa para definir controles de origen de datos que exponen datos jerárquicos, en lugar de datos tabulares o de estilo de lista, a controles de servidor web que derivan de la HierarchicalDataBoundControl clase , como el TreeView control . La interfaz define un único método, GetHierarchicalView, que recupera un objeto fuertemente tipado HierarchicalDataSourceView . Los controles de origen de datos que implementan esta interfaz admiten una vista jerárquica para cada nivel jerárquico de datos que representan. Las vistas del origen de datos no tienen nombre, como DataSourceView objetos, pero se identifican mediante su ruta jerárquica única, que es el viewPath parámetro pasado al GetHierarchicalView método .

Puede considerar un control de origen de datos como la combinación del IHierarchicalDataSource objeto y sus vistas asociadas en los datos subyacentes. Cada objeto asociado HierarchicalDataSourceView define las funciones de un control de origen de datos para el nivel jerárquico representado y, al igual que todos los objetos de vista del origen de datos ASP.NET, realiza operaciones como insertar, actualizar, eliminar y ordenar.

Los controles de origen de datos que exponen solo datos jerárquicos, como SiteMapDataSource, se derivan de la HierarchicalDataSourceControl clase . Otros controles de origen de datos que exponen sus datos como datos jerárquicos y datos tabulares, como XmlDataSource, se derivan de HierarchicalDataSourceControl pero implementan las IDataSource interfaces e IListSource .

Métodos

GetHierarchicalView(String)

Obtiene el objeto del asistente de la vista para la interfaz IHierarchicalDataSource para la ruta de acceso especificada.

Eventos

DataSourceChanged

Aparece cuando ha cambiado el almacenamiento de datos que representa la interfaz IHierarchicalDataSource.

Se aplica a

Consulte también