IHierarchicalDataSource Schnittstelle

  • Referenz

Definition

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

Stellt eine hierarchische Datenquelle dar, an die hierarchische datengebundene Steuerelemente, z. B. das TreeView-Steuerelement, gebunden werden können.

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

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie die abstrakte HierarchicalDataSourceControl Klasse erweitern, die die IHierarchicalDataSource Schnittstelle implementiert, um ein Datenquellensteuerelement zu erstellen, das Dateisysteminformationen anzeigt. Die FileSystemDataSource Klasse stellt eine Implementierung der GetHierarchicalView Methode bereit, die ein stark eingegebenes Ansichtsobjekt für einen angegebenen Dateisystempfad abruft. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die HierarchicalDataSourceControl Klasse bereitgestellt wird.

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

Hinweise

ASP.NET unterstützt eine Steuerelementdatenbindungsarchitektur, mit der Webserversteuerelemente die Bindung an Daten ermöglichen und diese auf konsistente Weise präsentieren können. Webserversteuerelemente, die an Daten binden, werden als datengebundene Steuerelemente bezeichnet, und die Klassen, die die Bindung erleichtern, werden als Datenquellensteuerelemente bezeichnet. Datenquellensteuerelemente können jede beliebige Datenquelle darstellen: eine Datei, einen Stream, eine relationale Datenbank, ein Geschäftsobjekt usw. Datenquellensteuerelemente präsentieren Daten auf konsistente Weise zu datengebundenen Steuerelementen, unabhängig von der Quelle oder dem Format der zugrunde liegenden Daten.

Datenquellensteuerelemente, die hierarchische Daten aus der HierarchicalDataSourceControl Klasse abgeleitet sind, was die Basis ASP.NET Implementierung der IHierarchicalDataSource Schnittstelle ist. Die IHierarchicalDataSource Schnittstelle wird verwendet, um Datenquellensteuerelemente zu definieren, die hierarchische Daten anstelle von Tabellar- oder Listenformatdaten auf Webserversteuerelementen verfügbar machen, die von der Klasse abgeleitet werden, z. B. das HierarchicalDataBoundControl TreeView Steuerelement. Die Schnittstelle definiert eine einzelne Methode, GetHierarchicalViewdie ein stark eingegebenes HierarchicalDataSourceView Objekt abruft. Datenquellensteuerelemente, die diese Schnittstelle implementieren, unterstützen eine hierarchische Ansicht für jede hierarchische Ebene von Daten, die sie darstellen. Die Datenquellenansichten werden nicht benannt, z DataSourceView . B. Objekte, sondern durch ihren eindeutigen hierarchischen Pfad identifiziert, der den viewPath Parameter an die GetHierarchicalView Methode übergeben hat.

Sie können sich ein Datenquellensteuerelement als Kombination des IHierarchicalDataSource Objekts und seiner zugeordneten Ansichten über die zugrunde liegenden Daten vorstellen. Jedes zugeordnete HierarchicalDataSourceView Objekt definiert die Funktionen eines Datenquellensteuerelements für die hierarchische Ebene, und führt wie alle ASP.NET Datenquellenansichtsobjekte Vorgänge wie Einfügen, Aktualisieren, Löschen und Sortieren aus.

Datenquellensteuerelemente, die nur hierarchische Daten verfügbar machen, wie z SiteMapDataSource. B. , werden aus der HierarchicalDataSourceControl Klasse abgeleitet. Andere Datenquellensteuerelemente, die ihre Daten sowohl als hierarchische Daten als auch tabellarische Daten verfügbar machen, wie z XmlDataSource. B. , werden von aber von HierarchicalDataSourceControl den IDataSource IListSource Schnittstellen abgeleitet.

Methoden

GetHierarchicalView(String)

Ruft das Sichthilfsobjekt für die IHierarchicalDataSource-Schnittstelle für den angegebenen Pfad ab.

Ereignisse

DataSourceChanged

Tritt ein, wenn der von der IHierarchicalDataSource-Schnittstelle dargestellte Datenspeicher geändert wurde.

Gilt für

Siehe auch