HierarchicalDataBoundControlAdapter Classe

Définition

Espace de noms:: System.Web.UI.WebControls.Adapters

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Personnalise le comportement d’un HierarchicalDataBoundControl objet avec lequel cet adaptateur de contrôle est associé, pour des requêtes de navigateur spécifiques.

public ref class HierarchicalDataBoundControlAdapter : System::Web::UI::WebControls::Adapters::WebControlAdapter

public class HierarchicalDataBoundControlAdapter : System.Web.UI.WebControls.Adapters.WebControlAdapter

type HierarchicalDataBoundControlAdapter = class
    inherit WebControlAdapter

Public Class HierarchicalDataBoundControlAdapter
Inherits WebControlAdapter

Héritage: Object

ControlAdapter

WebControlAdapter
HierarchicalDataBoundControlAdapter

Exemples

L’exemple de code suivant montre comment étendre la HierarchicalDataBoundControlAdapter classe pour afficher un contrôle hiérarchique TreeView lié à un XmlDataSource objet.

Cet exemple de code contient quatre objets :

Adaptateur dérivé de la HierarchicalDataBoundControlAdapter classe.
Fichier .aspx qui incorpore le contenu spécifique au contrôle et à l’appareil TreeView .
Fichier de navigateur pour lier l’adaptateur à un type d’appareil.
Fichier XML qui contient une liste hiérarchique d’employés.

Cet exemple de code se compose de quatre segments de code. Le premier segment de code montre comment étendre la HierarchicalDataBoundControlAdapter classe.

using System;
using System.Web;
using System.Web.UI;
using System.Security.Permissions;

namespace Contoso
{
    [AspNetHostingPermission(
        SecurityAction.Demand, 
        Level = AspNetHostingPermissionLevel.Minimal)]
    [AspNetHostingPermission(
        SecurityAction.InheritanceDemand, 
        Level = AspNetHostingPermissionLevel.Minimal)]
    public class HierarchicalTreeViewAdapter :
        System.Web.UI.WebControls.Adapters.HierarchicalDataBoundControlAdapter
    {
        // Return a strongly-typed TreeView control for adapter.
        protected new System.Web.UI.WebControls.TreeView Control
        {
            get
            {
                return (System.Web.UI.WebControls.TreeView)base.Control;
            }
        }

        // Verify the DataSourceID property is set prior to binding data.
        protected override void PerformDataBinding()
        {
            if (Control.DataSourceID != null)
            {
                base.PerformDataBinding();
            }
        }
    }
}

Imports System.Web
Imports System.Security.Permissions

Namespace Contoso

    <AspNetHostingPermission(SecurityAction.Demand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    Public Class HierarchicalTreeViewAdapter
        Inherits _
        System.Web.UI.WebControls.Adapters.HierarchicalDataBoundControlAdapter

        ' Return a strongly-typed TreeView control for adapter.
        Protected Overloads ReadOnly Property Control() As _
            System.Web.UI.WebControls.TreeView

            Get
                Return CType( _
                    MyBase.Control, _
                    System.Web.UI.WebControls.TreeView)
            End Get
        End Property

        ' Verify the DataSourceID property is set prior to binding data.
        Protected Overrides Sub PerformDataBinding()

            If (Not Control.DataSourceID Is Nothing) Then

                MyBase.PerformDataBinding()
            End If
        End Sub
    End Class
End Namespace

Le deuxième segment de code montre comment déclarer une TreeView liaison à une source de données XML.

<%@ page language="c#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>HierarchicalDataBoundControl Adapter</title>
</head>
<body>
    <form id="Form1" runat="server">
        <asp:TreeView ID="TreeView1" 
            Runat="server" 
            DataSourceID="XmlDataSource1">

            <DataBindings>
                <asp:TreeNodeBinding    
                    DataMember="employees" Text="Employees"/>
                <asp:TreeNodeBinding    
                    DataMember="employee" TextField="id" />
                <asp:TreeNodeBinding    
                    DataMember="name" TextField="fullname" />
            </DataBindings>
        </asp:TreeView>
        
        <asp:XmlDataSource ID="XmlDataSource1"  
            Runat="server" 
            DataFile="employees.xml" />
        <br />
    </form>
</body>
</html>

<%@ page language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>HierarchicalDataBoundControl Adapter</title>
</head>
<body>
    <form id="Form1" runat="server">
        <asp:TreeView ID="TreeView1" 
            Runat="server" 
            DataSourceID="XmlDataSource1">

            <DataBindings>
                <asp:TreeNodeBinding    
                    DataMember="employees" Text="Employees"/>
                <asp:TreeNodeBinding    
                    DataMember="employee" TextField="id" />
                <asp:TreeNodeBinding    
                    DataMember="name" TextField="fullname" />
            </DataBindings>
        </asp:TreeView>
        
        <asp:XmlDataSource ID="XmlDataSource1"  
            Runat="server" 
            DataFile="employees.xml" />
        <br />
    </form>
</body>
</html>

Le troisième segment de code montre comment lier le contrôle TreeView à l’adaptateur personnalisé pour les navigateurs s’exécutant sur Windows CE.

Le segment de code final fournit les données XML auxquelles le TreeView contrôle est lié.

Remarques

La HierarchicalDataBoundControlAdapter classe adapte le contrôle associé HierarchicalDataBoundControl pour modifier le balisage ou le comportement par défaut d’un navigateur spécifique. Vous pouvez étendre la HierarchicalDataBoundControlAdapter classe pour personnaliser davantage le rendu du HierarchicalDataBoundControl contrôle.

Un HierarchicalDataBoundControl contrôle est lié à une source de données et génère son interface utilisateur (ou hiérarchie de contrôle enfant, généralement), en énumérant les éléments de la source de données à laquelle il est lié. Pour plus d’informations sur les contrôles hiérarchiques liés aux données, consultez HierarchicalDataBoundControl.

Les adaptateurs de contrôle sont.NET composants qui gèrent une ou plusieurs étapes dans le cycle de vie d’un contrôle pour un navigateur spécifique. L’extension de la HierarchicalDataBoundControlAdapter classe permet d’accéder aux étapes de cycle de vie du HierarchicalDataBoundControl contrôle. Pour plus d’informations, consultez Vue d’ensemble architecturale du comportement du contrôle adaptatif.

La demande initiale d’un adaptateur provoque la recherche d’un adaptateur .NET Framework pour le contrôle, en fonction des caractéristiques du navigateur demandeur. Les fichiers de définition de navigateur sont utilisés par la HttpBrowserCapabilities classe pour identifier les caractéristiques du navigateur client et mapper l’adaptateur au type de navigateur.

Constructeurs

Nom	Description
HierarchicalDataBoundControlAdapter()	Initialise une nouvelle instance de la classe HierarchicalDataBoundControlAdapter.

Propriétés

Nom	Description
Browser	Obtient une référence aux fonctionnalités du navigateur du client qui effectuent la requête HTTP actuelle. (Hérité de ControlAdapter)
Control	Récupère une référence fortement typée au HierarchicalDataBoundControl contrôle associé à cet HierarchicalDataBoundControlAdapter objet.
IsEnabled	Obtient une valeur indiquant si le contrôle Web et tous ses contrôles parents sont activés. (Hérité de WebControlAdapter)
Page	Obtient une référence à la page où réside le contrôle associé à cet adaptateur. (Hérité de ControlAdapter)
PageAdapter	Obtient une référence à l’adaptateur de page de la page où réside le contrôle associé. (Hérité de ControlAdapter)

Méthodes

Nom	Description
BeginRender(HtmlTextWriter)	Appelé avant le rendu d’un contrôle. Dans une classe d’adaptateur dérivée, génère des balises ouvrantes requises par une cible spécifique, mais qui ne sont pas nécessaires par les navigateurs HTML. (Hérité de ControlAdapter)
CreateChildControls()	Crée les contrôles enfants spécifiques à la cible pour un contrôle composite. (Hérité de ControlAdapter)
EndRender(HtmlTextWriter)	Appelé après le rendu d’un contrôle. Dans une classe d’adaptateur dérivée, génère des balises fermante requises par une cible spécifique, mais qui ne sont pas nécessaires par les navigateurs HTML. (Hérité de ControlAdapter)
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
LoadAdapterControlState(Object)	Charge les informations d’état du contrôle de l’adaptateur enregistrées SaveAdapterControlState() lors d’une demande précédente sur la page où réside le contrôle associé à cet adaptateur de contrôle. (Hérité de ControlAdapter)
LoadAdapterViewState(Object)	Charge les informations d’état d’affichage de l’adaptateur enregistrées SaveAdapterViewState() lors d’une demande précédente sur la page où réside le contrôle associé à cet adaptateur de contrôle. (Hérité de ControlAdapter)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
OnInit(EventArgs)	Remplace la OnInit(EventArgs) méthode du contrôle associé. (Hérité de ControlAdapter)
OnLoad(EventArgs)	Remplace la OnLoad(EventArgs) méthode du contrôle associé. (Hérité de ControlAdapter)
OnPreRender(EventArgs)	Remplace la OnPreRender(EventArgs) méthode du contrôle associé. (Hérité de ControlAdapter)
OnUnload(EventArgs)	Remplace la OnUnload(EventArgs) méthode du contrôle associé. (Hérité de ControlAdapter)
PerformDataBinding()	Lie les données dans la source de données du contrôle hiérarchique associé lié aux données à l’adaptateur.
Render(HtmlTextWriter)	Génère le balisage spécifique à la cible pour le contrôle auquel l’adaptateur de contrôle est attaché. (Hérité de WebControlAdapter)
RenderBeginTag(HtmlTextWriter)	Crée la balise de début du contrôle Web dans le balisage transmis au navigateur cible. (Hérité de WebControlAdapter)
RenderChildren(HtmlTextWriter)	Génère le balisage spécifique à la cible pour les contrôles enfants dans un contrôle composite auquel l’adaptateur de contrôle est attaché. (Hérité de ControlAdapter)
RenderContents(HtmlTextWriter)	Génère le balisage interne spécifique à la cible pour le contrôle Web auquel l’adaptateur de contrôle est attaché. (Hérité de WebControlAdapter)
RenderEndTag(HtmlTextWriter)	Crée la balise de fin du contrôle Web dans le balisage transmis au navigateur cible. (Hérité de WebControlAdapter)
SaveAdapterControlState()	Enregistre les informations d’état du contrôle pour l’adaptateur de contrôle. (Hérité de ControlAdapter)
SaveAdapterViewState()	Enregistre les informations d’état d’affichage de l’adaptateur de contrôle. (Hérité de ControlAdapter)
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)

S’applique à

Voir aussi

Commentaires

Cette page a-t-elle été utile ?