IHierarchicalDataSource Interfaccia

Definizione

Rappresenta un'origine dati gerarchica a cui è possibile associare controlli associati a dati gerarchici come TreeView.

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

Esempio

Nell'esempio di codice seguente viene illustrato come estendere la classe astratta HierarchicalDataSourceControl , che implementa l'interfaccia IHierarchicalDataSource , per creare un controllo origine dati che visualizza le informazioni sul file system. La FileSystemDataSource classe fornisce un'implementazione del GetHierarchicalView metodo , che recupera un oggetto visualizzazione fortemente tipizzato per un percorso del file system specificato. Questo esempio di codice fa parte di un esempio più ampio fornito per la 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

Commenti

ASP.NET supporta un'architettura di data binding di controllo che consente ai controlli server Web di eseguire il binding ai dati e presentarlo in modo coerente. I controlli server Web associati ai dati sono denominati controlli associati a dati e le classi che facilitano l'associazione vengono denominate controlli origine dati. I controlli origine dati possono rappresentare qualsiasi origine dati: un file, un flusso, un database relazionale, un oggetto business e così via. I controlli origine dati presentano dati in modo coerente ai controlli associati a dati, indipendentemente dall'origine o dal formato dei dati sottostanti.

I controlli origine dati che rappresentano i dati gerarchici derivano dalla HierarchicalDataSourceControl classe , ovvero l'implementazione di base ASP.NET dell'interfacciaIHierarchicalDataSource. L'interfaccia IHierarchicalDataSource viene usata per definire controlli origine dati che espongono dati gerarchici, anziché dati tabulari o di tipo elenco, ai controlli server Web che derivano dalla HierarchicalDataBoundControl classe , ad esempio il TreeView controllo . L'interfaccia definisce un singolo metodo, GetHierarchicalView, che recupera un oggetto fortemente tipizzato HierarchicalDataSourceView . I controlli origine dati che implementano questa interfaccia supportano una visualizzazione gerarchica per ogni livello gerarchico di dati che rappresentano. Le viste origine dati non sono denominate, ad esempio DataSourceView gli oggetti , ma sono identificate dal percorso gerarchico univoco, ovvero il viewPath parametro passato al GetHierarchicalView metodo .

È possibile considerare un controllo origine dati come la combinazione dell'oggetto IHierarchicalDataSource e delle visualizzazioni associate sui dati sottostanti. Ogni oggetto associato HierarchicalDataSourceView definisce le funzionalità di un controllo origine dati per il livello gerarchico rappresentato e, come tutti gli oggetti vista origine dati ASP.NET, esegue operazioni quali inserimento, aggiornamento, eliminazione e ordinamento.

I controlli origine dati che espongono solo dati gerarchici, ad esempio SiteMapDataSource, sono derivati dalla HierarchicalDataSourceControl classe . Altri controlli origine dati che espongono i dati come dati gerarchici e dati tabulari, ad esempio XmlDataSource, sono derivati da HierarchicalDataSourceControl , ma implementano le IDataSource interfacce e IListSource .

Metodi

GetHierarchicalView(String)

Ottiene l'oggetto di supporto della visualizzazione per l'interfaccia IHierarchicalDataSource per il percorso specificato.

Eventi

DataSourceChanged

Si verifica quando l'archivio dati rappresentato dall'interfaccia IHierarchicalDataSource viene modificato.

Si applica a

Vedi anche