IHierarchicalDataSource Interfaccia
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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. |