IHierarchicalDataSource Interfaccia

Definizione

public interface class IHierarchicalDataSource

public interface IHierarchicalDataSource

type IHierarchicalDataSource = interface

Public Interface IHierarchicalDataSource

Derivato

System.Web.UI.HierarchicalDataSourceControl

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 associazione dati di controllo che consente ai controlli server Web di eseguire l'associazione ai dati e di presentarli in modo coerente. I controlli server Web che si associano 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 dati gerarchici derivano dalla classe , ovvero l'implementazione di base ASP.NET dell'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 vengono 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 viste associate sui dati sottostanti. Ogni oggetto HierarchicalDataSourceView associato 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 .

Vedi anche

• HierarchicalDataSourceControl
• HierarchicalDataSourceView
• HierarchicalDataBoundControl
• IDataSource
• SiteMapDataSource
• XmlDataSource