IHierarchicalDataSource Schnittstelle

Definition

Stellt eine hierarchische Datenquelle dar, an die hierarchische datengebundene Steuerelemente, z. B. das TreeView-Steuerelement, gebunden werden können.Represents a hierarchical data source that hierarchical data-bound controls such as TreeView can bind to.

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

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die abstrakte HierarchicalDataSourceControl Klasse, die die IHierarchicalDataSource -Schnittstelle implementiert, erweitert wird, um ein Datenquellen-Steuerelement zu erstellen, das Dateisystem Informationen anzeigt.The following code example demonstrates how to extend the abstract HierarchicalDataSourceControl class, which implements the IHierarchicalDataSource interface, to create a data source control that displays file system information. Die FileSystemDataSource -Klasse stellt eine Implementierung GetHierarchicalView der-Methode bereit, die ein stark typisiertes Ansichts Objekt für einen angegebenen Dateisystempfad abruft.The FileSystemDataSource class provides an implementation of the GetHierarchicalView method, which retrieves a strongly typed view object for a specified file system path. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die HierarchicalDataSourceControl -Klasse bereitgestellt wird.This code example is part of a larger example provided for the HierarchicalDataSourceControl class.

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 Steuerelement Daten Bindungs Architektur, mit der Webserver Steuerelemente Daten an Daten binden und konsistent darstellen können.ASP.NET supports a control data-binding architecture that enables Web server controls to bind to data and present it in a consistent fashion. Webserver Steuerelemente, die an Daten gebunden werden, werden als Daten gebundene Steuerelemente bezeichnet, und die Klassen, die die Bindung vereinfachen, werden als Datenquellen Steuerelemente bezeichnet.Web server controls that bind to data are called data-bound controls, and the classes that facilitate binding are called data source controls. Datenquellensteuerelemente können jede beliebige Datenquelle darstellen: eine Datei, einen Stream, eine relationale Datenbank, ein Geschäftsobjekt usw.Data source controls can represent any data source: a file, a stream, a relational database, a business object, and so on. Datenquellen-Steuerelemente präsentieren Daten auf konsistente Weise für Daten gebundene Steuerelemente, unabhängig von der Quelle oder dem Format der zugrunde liegenden Daten.Data source controls present data in a consistent way to data-bound controls, regardless of the source or format of the underlying data.

Datenquellen Steuerelemente, die hierarchische Daten darstellen HierarchicalDataSourceControl , werden von der-Klasse abgeleitet. Dies ist IHierarchicalDataSource die ASP.net-Basis Implementierung der-Schnittstelle.Data source controls that represent hierarchical data derive from the HierarchicalDataSourceControl class, which is the base ASP.NET implementation of the IHierarchicalDataSource interface. Die IHierarchicalDataSource -Schnittstelle wird verwendet, um Datenquellen Steuerelemente zu definieren, die hierarchische Daten anstelle von Tabellen-oder Listenformat Daten für Webserver Steuerelemente HierarchicalDataBoundControl bereitstellen, die von TreeView der-Klasse abgeleitet werden, z. b. das-SteuerelementThe IHierarchicalDataSource interface is used to define data source controls that expose hierarchical data, rather than tabular or list-style data, to Web server controls that derive from the HierarchicalDataBoundControl class, such as the TreeView control. Die-Schnittstelle definiert eine einzige GetHierarchicalViewMethode,, die ein stark typisiertes HierarchicalDataSourceView -Objekt abruft.The interface defines a single method, GetHierarchicalView, which retrieves a strongly typed HierarchicalDataSourceView object. Datenquellen Steuerelemente, die diese Schnittstelle implementieren, unterstützen eine hierarchische Ansicht für jede hierarchische Datenebene, die Sie darstellen.Data source controls that implement this interface support a hierarchical view for each hierarchical level of data they represent. Die Datenquellen Sichten werden nicht wie DataSourceView Objekte benannt, sondern durch ihren eindeutigen hierarchischen Pfad identifiziert. Dies ist der viewPath Parameter, der an die GetHierarchicalView Methode übergeben wird.The data source views are not named, like DataSourceView objects, but are identified by their unique hierarchical path, which is the viewPath parameter passed to the GetHierarchicalView method.

Sie können sich ein Datenquellen-Steuerelement als die Kombination IHierarchicalDataSource aus dem-Objekt und den zugehörigen Sichten für die zugrunde liegenden Daten vorstellen.You can think of a data source control as the combination of the IHierarchicalDataSource object and its associated views on the underlying data. Jedes zugeordnete-Objekt definiert die Funktionen eines Datenquellen-Steuer Elements für die hierarchische Ebene, die dargestellt wird, und führt wie alle ASP.NET-Datenquellen Sicht-Objekte Vorgänge wie INSERT, Update, DELETE und Sort aus. HierarchicalDataSourceViewEach associated HierarchicalDataSourceView object defines the capabilities of a data source control for the hierarchical level represented, and, like all ASP.NET data source view objects, performs operations such as insert, update, delete, and sort.

Datenquellen Steuerelemente, die nur hierarchische Daten verfügbar SiteMapDataSourcemachen, z. b HierarchicalDataSourceControl ., werden von der-Klasse abgeleitet.Data source controls that expose only hierarchical data, such as SiteMapDataSource, are derived from the HierarchicalDataSourceControl class. Andere Datenquellen-Steuerelemente, die Ihre Daten als hierarchische Daten und tabellarische Daten XmlDataSourceverfügbar machen, wie HierarchicalDataSourceControl z. b. IListSource , werden von abgeleitet, implementieren jedoch die IDataSource Schnittstellen und.Other data source controls that expose their data as both hierarchical data and tabular data, such as XmlDataSource, are derived from HierarchicalDataSourceControl but implement the IDataSource and IListSource interfaces.

Methoden

GetHierarchicalView(String)

Ruft das Sichthilfsobjekt für die IHierarchicalDataSource-Schnittstelle für den angegebenen Pfad ab.Gets the view helper object for the IHierarchicalDataSource interface for the specified path.

Ereignisse

DataSourceChanged

Tritt ein, wenn der von der IHierarchicalDataSource-Schnittstelle dargestellte Datenspeicher geändert wurde.Occurs when the data storage that the IHierarchicalDataSource interface represents has changed.

Gilt für:

Siehe auch