IHierarchicalDataSource Interface

  • Référence

Définition

Espace de noms:
System.Web.UI
Assembly:
System.Web.dll

Représente une source de données hiérarchique à laquelle des contrôles liés aux données hiérarchiques, tels que TreeView, peuvent se lier.

public interface class IHierarchicalDataSource
public interface IHierarchicalDataSource
type IHierarchicalDataSource = interface
Public Interface IHierarchicalDataSource
Dérivé

Exemples

L’exemple de code suivant montre comment étendre la classe abstraite HierarchicalDataSourceControl , qui implémente l’interface IHierarchicalDataSource , pour créer un contrôle de source de données qui affiche les informations du système de fichiers. La FileSystemDataSource classe fournit une implémentation de la GetHierarchicalView méthode, qui récupère un objet de vue fortement typé pour un chemin d’accès de système de fichiers spécifié. Cet exemple de code fait partie d’un exemple plus grand fourni pour 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

Remarques

ASP.NET prend en charge une architecture de liaison de données de contrôle qui permet aux contrôles serveur Web de se lier aux données et de les présenter de manière cohérente. Les contrôles serveur web qui se lient aux données sont appelés contrôles liés aux données, et les classes qui facilitent la liaison sont appelées contrôles de source de données. Les contrôles de source de données peuvent représenter n’importe quelle source de données : un fichier, un flux, une base de données relationnelle, un objet métier, et ainsi de suite. Les contrôles de source de données présentent des données de manière cohérente aux contrôles liés aux données, quelle que soit la source ou le format des données sous-jacentes.

Contrôles de source de données qui représentent des données hiérarchiques dérivent de la HierarchicalDataSourceControl classe, qui est la base ASP.NET implémentation de l’interfaceIHierarchicalDataSource. L’interface IHierarchicalDataSource est utilisée pour définir des contrôles de source de données qui exposent des données hiérarchiques, plutôt que des données de style tabulaire ou de type liste, aux contrôles serveur Web qui dérivent de la HierarchicalDataBoundControl classe, tels que le TreeView contrôle. L’interface définit une méthode unique, GetHierarchicalViewqui récupère un objet fortement typé HierarchicalDataSourceView . Les contrôles de source de données qui implémentent cette interface prennent en charge une vue hiérarchique pour chaque niveau hiérarchique de données qu’elles représentent. Les vues de source de données ne sont pas nommées, comme DataSourceView les objets, mais sont identifiées par leur chemin hiérarchique unique, qui est le viewPath paramètre passé à la GetHierarchicalView méthode.

Vous pouvez considérer un contrôle de source de données comme la combinaison de l’objet IHierarchicalDataSource et de ses vues associées sur les données sous-jacentes. Chaque objet associé HierarchicalDataSourceView définit les fonctionnalités d’un contrôle de source de données pour le niveau hiérarchique représenté, et, comme tous les objets de vue de source de données ASP.NET, effectue des opérations telles que l’insertion, la mise à jour, la suppression et le tri.

Les contrôles de source de données qui exposent uniquement des données hiérarchiques, telles que SiteMapDataSource, sont dérivés de la HierarchicalDataSourceControl classe. D’autres contrôles de source de données qui exposent leurs données en tant que données hiérarchiques et données tabulaires, telles que XmlDataSource, sont dérivés, HierarchicalDataSourceControl mais implémentent les interfaces et IListSource les IDataSource données.

Méthodes

GetHierarchicalView(String)

Obtient l'objet d'assistance à l'affichage de l'interface IHierarchicalDataSource pour le chemin d'accès spécifié.

Événements

DataSourceChanged

Se produit en cas de modification du stockage des données que l'interface IHierarchicalDataSource représente.

S’applique à

Voir aussi