HierarchicalDataBoundControl Classe

Définition

Espace de noms:

System.Web.UI.WebControls

Assembly:

System.Web.dll

Sert de classe de base pour tous les contrôles liés aux données ASP.NET version 2.0 qui affichent leurs données de manière hiérarchique.

public ref class HierarchicalDataBoundControl abstract : System::Web::UI::WebControls::BaseDataBoundControl

public abstract class HierarchicalDataBoundControl : System.Web.UI.WebControls.BaseDataBoundControl

type HierarchicalDataBoundControl = class
    inherit BaseDataBoundControl

Public MustInherit Class HierarchicalDataBoundControl
Inherits BaseDataBoundControl

Héritage

Object

Control

WebControl

BaseDataBoundControl

HierarchicalDataBoundControl

Dérivé

System.Web.UI.WebControls.Menu

System.Web.UI.WebControls.TreeView

Exemples

L’exemple de code suivant montre comment dériver une classe de la HierarchicalDataBoundControl classe pour créer un contrôle personnalisé lié aux données. Le GeneologyTree contrôle affiche une pre section HTML avec une arborescence de texte pour les données récupérées à partir d’un contrôle de source de données associé.

using System;
using System.Collections;
using System.ComponentModel;
using System.Security.Permissions;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;

namespace Samples.AspNet.CS.Controls {

    [AspNetHostingPermission(SecurityAction.Demand, 
        Level=AspNetHostingPermissionLevel.Minimal)]
    [AspNetHostingPermission(SecurityAction.InheritanceDemand, 
        Level=AspNetHostingPermissionLevel.Minimal)]
    public class GeneologyTree : HierarchicalDataBoundControl {

        private TreeNode rootNode;
        public TreeNode RootNode {
            get {
                rootNode ??= new TreeNode(String.Empty);
                return rootNode;
            }
        }
        
        private ArrayList nodes;
        public ArrayList Nodes {
            get {
                if (null == nodes) {
                    nodes = new ArrayList();
                }
                return nodes;
            }
        }
        public string DataTextField {
            get {
                object o = ViewState["DataTextField"];
                return((o == null) ? string.Empty : (string)o);
            }
            set {
                ViewState["DataTextField"] = value;
                if (Initialized) {
                    OnDataPropertyChanged();
                }
            }
        }
        private int _maxDepth = 0;
        protected override void PerformDataBinding() {
            base.PerformDataBinding();

            // Do not attempt to bind data if there is no
            // data source set.
            if (!IsBoundUsingDataSourceID && (DataSource == null)) {
                return;
            }
            
            HierarchicalDataSourceView view = GetData(RootNode.DataPath);
            
            if (view == null) {
                throw new InvalidOperationException
                    ("No view returned by data source control.");
            }                                  
            
            IHierarchicalEnumerable enumerable = view.Select();
            if (enumerable != null) {
                            
                Nodes.Clear();
                                
                try {
                    RecurseDataBindInternal(RootNode, enumerable, 1);
                }
                finally {
                }
            }
        }
        private void RecurseDataBindInternal(TreeNode node, 
            IHierarchicalEnumerable enumerable, int depth) {                                    
                        
            foreach(object item in enumerable) {
                IHierarchyData data = enumerable.GetHierarchyData(item);

                if (null != data) {
                    // Create an object that represents the bound data
                    // to the control.
                    TreeNode newNode = new TreeNode();
                    RootViewNode rvnode = new RootViewNode();
                    
                    rvnode.Node = newNode;
                    rvnode.Depth = depth;

                    // The dataItem is not just a string, but potentially
                    // an XML node or some other container. 
                    // If DataTextField is set, use it to determine which 
                    // field to render. Otherwise, use the first field.                    
                    if (DataTextField.Length > 0) {
                        newNode.Text = DataBinder.GetPropertyValue
                            (data, DataTextField, null);
                    }
                    else {
                        PropertyDescriptorCollection props = 
                            TypeDescriptor.GetProperties(data);

                        // Set the "default" value of the node.
                        newNode.Text = String.Empty;                        

                        // Set the true data-bound value of the TextBox,
                        // if possible.
                        if (props.Count >= 1) {                        
                            if (null != props[0].GetValue(data)) {
                                newNode.Text = 
                                    props[0].GetValue(data).ToString();
                            } 
                        }
                    }

                    Nodes.Add(rvnode);                    
                    
                    if (data.HasChildren) {
                        IHierarchicalEnumerable newEnumerable = 
                            data.GetChildren();
                        if (newEnumerable != null) {                            
                            RecurseDataBindInternal(newNode, 
                                newEnumerable, depth+1 );
                        }
                    }
                    
                    if ( _maxDepth < depth) _maxDepth = depth;
                }
            }
        }
        protected override void Render(HtmlTextWriter writer) {
                        
            writer.WriteLine("<PRE>");                        
            int currentDepth = 1;
            int currentTextLen = 0;
            
            foreach (RootViewNode rvnode in Nodes) {
                if (rvnode.Depth == currentDepth) {
                    string output = "  " + rvnode.Node.Text + "  ";
                    writer.Write(output);
                    currentTextLen = currentTextLen + output.Length;
                }
                else {
                    writer.WriteLine("");
                    // Some very basic white-space formatting
                    int halfLine = currentTextLen / 2;
                    for (int i=0;i<halfLine;i++) {
                        writer.Write(' ');
                    }
                    writer.Write('|');
                    writer.WriteLine("");
                    ++currentDepth; 
                    currentTextLen = 0;
                    for (int j=0;j<halfLine;j++) {
                        writer.Write(' ');
                    }
                    string output = "  " + rvnode.Node.Text + "  ";
                    writer.Write(output);
                    currentTextLen = currentTextLen + output.Length;                    
                }                                                           
            }
            writer.WriteLine("</PRE>");
        }
        
        private class RootViewNode { 
            public TreeNode Node;
            public int Depth;
        }
    }
}

Imports System.Collections
Imports System.ComponentModel
Imports System.Security.Permissions
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls

Namespace Samples.AspNet.VB.Controls

    <AspNetHostingPermission(SecurityAction.Demand, _
      Level:=AspNetHostingPermissionLevel.Minimal), _
      AspNetHostingPermission(SecurityAction.InheritanceDemand, _
      Level:=AspNetHostingPermissionLevel.Minimal)> _
    Public Class GeneologyTree
        Inherits HierarchicalDataBoundControl

        Dim MaxDepth As Integer = 0

        Private aRootNode As TreeNode
        Public ReadOnly Property RootNode() As TreeNode
            Get
                If aRootNode Is Nothing Then
                    aRootNode = New TreeNode(String.Empty)
                End If
                Return aRootNode
            End Get
        End Property

        Private alNodes As ArrayList
        Public ReadOnly Property Nodes() As ArrayList
            Get
                If alNodes Is Nothing Then
                    alNodes = New ArrayList()
                End If
                Return alNodes
            End Get
        End Property

        Public Property DataTextField() As String
            Get
                Dim o As Object = ViewState("DataTextField")
                If o Is Nothing Then
                    Return String.Empty
                Else
                    Return CStr(o)
                End If
            End Get
            Set(ByVal value As String)
                ViewState("DataTextField") = value
                If Initialized Then
                    OnDataPropertyChanged()
                End If
            End Set
        End Property

        Protected Overrides Sub PerformDataBinding()
            MyBase.PerformDataBinding()

            ' Do not attempt to bind data if there is no
            ' data source set.
            If Not IsBoundUsingDataSourceID AndAlso DataSource Is Nothing Then
                Return
            End If

            Dim view As HierarchicalDataSourceView = GetData(RootNode.DataPath)

            If view Is Nothing Then
                Throw New InvalidOperationException _
                ("No view returned by data source control.")
            End If

            Dim enumerable As IHierarchicalEnumerable = view.Select()
            If Not (enumerable Is Nothing) Then

                Nodes.Clear()

                Try
                    RecurseDataBindInternal(RootNode, enumerable, 1)
                Finally
                End Try
            End If

        End Sub

        Private Sub RecurseDataBindInternal(ByVal node As TreeNode, _
            ByVal enumerable As IHierarchicalEnumerable, _
            ByVal depth As Integer)

            Dim item As Object
            For Each item In enumerable

                Dim data As IHierarchyData = enumerable.GetHierarchyData(item)

                If Not data Is Nothing Then

                    ' Create an object that represents the bound data
                    ' to the control.
                    Dim newNode As New TreeNode()
                    Dim rvnode As New RootViewNode()

                    rvnode.Node = newNode
                    rvnode.Depth = depth

                    ' The dataItem is not just a string, but potentially
                    ' an XML node or some other container. 
                    ' If DataTextField is set, use it to determine which 
                    ' field to render. Otherwise, use the first field.                    
                    If DataTextField.Length > 0 Then
                        newNode.Text = DataBinder.GetPropertyValue _
                        (data, DataTextField, Nothing)
                    Else
                        Dim props As PropertyDescriptorCollection = _
                        TypeDescriptor.GetProperties(data)

                        ' Set the "default" value of the node.
                        newNode.Text = String.Empty

                        ' Set the true data-bound value of the TextBox,
                        ' if possible.
                        If props.Count >= 1 Then
                            If Not props(0).GetValue(data) Is Nothing Then
                                newNode.Text = props(0).GetValue(data).ToString()
                            End If
                        End If
                    End If

                    Nodes.Add(rvnode)

                    If data.HasChildren Then
                        Dim newEnumerable As IHierarchicalEnumerable = _
                            data.GetChildren()
                        If Not (newEnumerable Is Nothing) Then
                            RecurseDataBindInternal(newNode, _
                            newEnumerable, depth + 1)
                        End If
                    End If

                    If MaxDepth < depth Then
                        MaxDepth = depth
                    End If
                End If
            Next item

        End Sub

        Protected Overrides Sub Render(ByVal writer As HtmlTextWriter)

            writer.WriteLine("<PRE>")
            Dim currentDepth As Integer = 1
            Dim currentTextLen As Integer = 0

            Dim rvnode As RootViewNode
            For Each rvnode In Nodes
                If rvnode.Depth = currentDepth Then
                    Dim output As String = "  " + rvnode.Node.Text + "  "
                    writer.Write(output)
                    currentTextLen = currentTextLen + output.Length
                Else
                    writer.WriteLine("")

                    ' Some very basic white-space formatting.
                    ' The implicit conversion to an Integer is fine, as 
                    ' a general estimate is acceptable for this 
                    ' simple example.
                    Dim halfLine As Integer = CInt(currentTextLen / 2)
                    Dim i As Integer
                    For i = 0 To halfLine
                        writer.Write(" "c)
                    Next i
                    writer.Write("|"c)
                    writer.WriteLine("")
                    currentDepth += 1
                    Dim j As Integer
                    For j = 0 To halfLine
                        writer.Write(" "c)
                    Next j
                    Dim output As String = "  " + rvnode.Node.Text + "  "
                    writer.Write(output)
                    currentTextLen = currentTextLen + output.Length
                End If
            Next rvnode
            writer.WriteLine("</PRE>")

        End Sub


        Private Class RootViewNode
            Public Node As TreeNode
            Public Depth As Integer
        End Class
    End Class
End Namespace

L’exemple de code suivant montre comment utiliser le GeneologyTree contrôle, défini dans l’exemple précédent, et le lier à un XmlDataSource contrôle.

<%@Page language="c#" %>
<%@ Register TagPrefix="aspSample" 
    Namespace="Samples.AspNet.CS.Controls" 
    Assembly="Samples.AspNet.CS.Controls" %>

<!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>
    <title>C# Example</title>
  </head>

  <body>
    <form id="Form1" method="post" runat="server">

        <aspSample:geneologytree
          id="GeneologyTree1"
          runat="server"
          datatextfield="title"
          datasourceid="XmlDataSource1" />

        <asp:xmldatasource
          id="XmlDataSource1"
          datafile="geneology.xml"          
          runat="server" />
          
    </form>
  </body>
</html>

<%@Page language="VB" %>
<%@ Register TagPrefix="aspSample" 
    Namespace="Samples.AspNet.VB.Controls" 
    Assembly="Samples.AspNet.VB.Controls" %>

<!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>
    <title>VB Example</title>
  </head>

  <body>
    <form id="Form1" method="post" runat="server">

        <aspSample:geneologytree
          id="GeneologyTree1"
          runat="server"
          datatextfield="title"
          datasourceid="XmlDataSource1" />

        <asp:xmldatasource
          id="XmlDataSource1"
          datafile="geneology.xml"          
          runat="server" />
          
    </form>
  </body>
</html>

Le fichier geneology.xml auquel vous accédez dans l’exemple de code contient les données suivantes.

<family>  
  <member title="great-grandfather">  
    <member title="grandfather" >  
      <member title="child" />  
      <member title="father" >  
         <member title="son" />  
      </member>  
    </member>  
  </member>  
</family>  

Remarques

La HierarchicalDataBoundControl classe est la classe de base utilisée pour ASP.NET contrôles qui récupèrent des données à partir d’un contrôle de source de données hiérarchique ASP.NET et lient les éléments d’interface utilisateur du contrôle à ces données pour affichage. Les TreeView classes et Menu dérivent de HierarchicalDataBoundControl.

Les développeurs de pages n’utilisent pas directement la HierarchicalDataBoundControl classe ; ils utilisent plutôt des contrôles qui dérivent de cette classe.

Les développeurs de contrôles étendent cette classe pour créer des contrôles liés aux données qui fonctionnent avec des classes qui implémentent l’interface IHierarchicalDataSource et les classes qui dérivent des HierarchicalDataSourceControl classes et HierarchicalDataSourceView . Lors de la dérivation d’une classe à partir de la HierarchicalDataBoundControl classe , remplacez la PerformDataBinding méthode pour lier les éléments d’interface utilisateur de votre contrôle aux données récupérées par la GetData méthode . Dans la plupart des cas, la PerformDataBinding méthode est la seule méthode que vous remplacerez dans votre classe dérivée.

Pour ASP.NET contrôles liés aux données 2.0, la PerformSelect méthode est l’équivalent de la méthode et est appelée pour lier des données au moment de l’exécution DataBind . La PerformSelect méthode appelle les GetData méthodes et PerformDataBinding .

Constructeurs

HierarchicalDataBoundControl()

Initialise une nouvelle instance de la classe HierarchicalDataBoundControl.

Propriétés

AccessKey	Obtient ou définit la touche d'accès rapide qui vous permet de naviguer rapidement vers le contrôle serveur Web. (Hérité de WebControl)
Adapter	Obtient l'adaptateur spécifique au navigateur pour le contrôle. (Hérité de Control)
AppRelativeTemplateSourceDirectory	Obtient ou définit le répertoire virtuel relatif à l'application de l'objet Page ou UserControl qui contient ce contrôle. (Hérité de Control)
Attributes	Obtient la collection d'attributs arbitraires (pour le rendu uniquement) qui ne correspondent pas à des propriétés du contrôle. (Hérité de WebControl)
BackColor	Obtient ou définit la couleur d'arrière-plan du contrôle serveur Web. (Hérité de WebControl)
BindingContainer	Obtient le contrôle qui contient la liaison de données de ce contrôle. (Hérité de Control)
BorderColor	Obtient ou définit la couleur de bordure du contrôle Web. (Hérité de WebControl)
BorderStyle	Obtient ou définit le style de bordure du contrôle serveur Web. (Hérité de WebControl)
BorderWidth	Obtient ou définit la largeur de bordure du contrôle serveur Web. (Hérité de WebControl)
ChildControlsCreated	Obtient une valeur qui indique si des contrôles enfants du contrôle serveur ont été créés. (Hérité de Control)
ClientID	Obtient l’ID de contrôle du balisage HTML généré par ASP.NET. (Hérité de Control)
ClientIDMode	Obtient ou définit l'algorithme utilisé pour générer la valeur de la propriété ClientID. (Hérité de Control)
ClientIDSeparator	Obtient une valeur de caractère représentant le caractère de séparation utilisé dans la propriété ClientID. (Hérité de Control)
Context	Obtient l'objet HttpContext associé au contrôle serveur pour la demande Web en cours. (Hérité de Control)
Controls	Obtient un objet ControlCollection qui représente les contrôles enfants pour un contrôle serveur spécifié dans la hiérarchie de l’interface utilisateur. (Hérité de Control)
ControlStyle	Obtient le style d'un contrôle serveur Web. Cette propriété est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl)
ControlStyleCreated	Obtient une valeur indiquant si un objet Style a été créé pour la propriété ControlStyle. Cette propriété est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl)
CssClass	Obtient ou définit la classe de feuille de style en cascade (CSS, Cascading Style Sheet) rendue par le contrôle serveur Web sur le client. (Hérité de WebControl)
DataItemContainer	Obtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataItemContainer. (Hérité de Control)
DataKeysContainer	Obtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataKeysControl. (Hérité de Control)
DataSource	Obtient ou définit l'objet duquel le contrôle lié aux données récupère sa liste d'éléments de données. (Hérité de BaseDataBoundControl)
DataSourceID	Obtient ou définit l’ID du contrôle à partir duquel le contrôle lié aux données récupère sa liste d’éléments de données.
DesignMode	Obtient une valeur indiquant si un contrôle est utilisé sur une aire de conception. (Hérité de Control)
Enabled	Obtient ou définit une valeur indiquant si le contrôle serveur Web est activé. (Hérité de WebControl)
EnableTheming	Obtient ou définit une valeur indiquant si les thèmes s'appliquent à ce contrôle. (Hérité de WebControl)
EnableViewState	Obtient ou définit une valeur indiquant si le contrôle serveur conserve son état d’affichage, et l’état d’affichage de tous les contrôles enfants qu’il contient, au client demandeur. (Hérité de Control)
Events	Obtient la liste des délégués de gestionnaires d'événements pour le contrôle. Cette propriété est en lecture seule. (Hérité de Control)
Font	Obtient les propriétés de police associées au contrôle serveur Web. (Hérité de WebControl)
ForeColor	Obtient ou définit la couleur de premier plan (généralement la couleur du texte) du contrôle serveur Web. (Hérité de WebControl)
HasAttributes	Obtient une valeur indiquant si le contrôle a des attributs définis. (Hérité de WebControl)
HasChildViewState	Obtient une valeur indiquant si les contrôles enfants du contrôle serveur en cours possèdent des paramètres d'état d'affichage enregistrés. (Hérité de Control)
Height	Obtient ou définit la hauteur du contrôle serveur Web. (Hérité de WebControl)
ID	Obtient ou définit l'ID programmatique assigné au contrôle serveur. (Hérité de Control)
IdSeparator	Obtient le caractère utilisé pour séparer des identificateurs de contrôle. (Hérité de Control)
Initialized	Obtient une valeur indiquant si le contrôle lié aux données a été initialisé. (Hérité de BaseDataBoundControl)
IsBoundUsingDataSourceID	Obtient une valeur indiquant si la propriété DataSourceID est définie. (Hérité de BaseDataBoundControl)
IsChildControlStateCleared	Obtient une valeur indiquant si les contrôles contenus dans ce contrôle utilisent l'état du contrôle. (Hérité de Control)
IsDataBindingAutomatic	Obtient une valeur qui indique si la liaison de données est automatique. (Hérité de BaseDataBoundControl)
IsEnabled	Obtient une valeur indiquant si le contrôle est activé. (Hérité de WebControl)
IsTrackingViewState	Obtient une valeur qui indique si le contrôle serveur enregistre les modifications apportées à son état d'affichage. (Hérité de Control)
IsUsingModelBinders	En cas d'implémentation dans une classe dérivée, obtient une valeur qui indique si le contrôle utilise des classeurs de modèles. (Hérité de BaseDataBoundControl)
IsViewStateEnabled	Obtient une valeur indiquant si l'état d'affichage est activé pour ce contrôle. (Hérité de Control)
LoadViewStateByID	Obtient une valeur indiquant si le contrôle participe au chargement de son état d'affichage par ID et non par index. (Hérité de Control)
NamingContainer	Obtient une référence au conteneur d'attribution de noms du contrôle serveur, qui crée un espace de noms unique pour différencier les contrôles serveur dont la propriété ID possède la même valeur. (Hérité de Control)
Page	Obtient une référence à l'instance de Page qui contient le contrôle serveur. (Hérité de Control)
Parent	Obtient une référence au contrôle parent du contrôle serveur dans la hiérarchie des contrôles de la page. (Hérité de Control)
RenderingCompatibility	Obtient une valeur qui spécifie la version ASP.NET avec laquelle le HTML restitué sera compatible. (Hérité de Control)
RequiresDataBinding	Obtient ou définit une valeur indiquant si la méthode DataBind() doit être appelée. (Hérité de BaseDataBoundControl)
Site	Obtient des informations sur le conteneur qui héberge le contrôle en cours lorsqu'il est rendu sur une aire de conception. (Hérité de Control)
SkinID	Obtient ou définit l’apparence à appliquer au contrôle. (Hérité de WebControl)
Style	Obtient une collection d'attributs de texte qui sont rendus en tant qu'attribut de style sur la balise extérieure d'un contrôle serveur Web. (Hérité de WebControl)
SupportsDisabledAttribute	Obtient une valeur qui indique si le contrôle doit définir l'attribut disabled de l'élément HTML rendu avec la valeur « disabled » quand la propriété IsEnabled du contrôle a la valeur false. (Hérité de BaseDataBoundControl)
TabIndex	Obtient ou définit l'index de tabulation du contrôle serveur Web. (Hérité de WebControl)
TagKey	Obtient la valeur HtmlTextWriterTag qui correspond à ce contrôle serveur Web. Cette propriété est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl)
TagName	Obtient le nom de la balise du contrôle. Cette propriété est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl)
TemplateControl	Obtient ou définit une référence au modèle qui contient ce contrôle. (Hérité de Control)
TemplateSourceDirectory	Obtient le répertoire virtuel du Page ou du UserControl qui contient le contrôle serveur en cours. (Hérité de Control)
ToolTip	Obtient ou définit le texte affiché quand le pointeur de la souris est positionné sur le contrôle serveur Web. (Hérité de WebControl)
UniqueID	Obtient l'identificateur unique qualifié sur le plan hiérarchique du contrôle serveur. (Hérité de Control)
ValidateRequestMode	Obtient ou définit une valeur qui indique si le contrôle vérifie l'entrée cliente du navigateur à la recherche de valeurs potentiellement dangereuses. (Hérité de Control)
ViewState	Obtient un dictionnaire d'informations d'état qui vous permet d'enregistrer et de restaurer l'état d'affichage d'un contrôle serveur entre plusieurs demandes de la même page. (Hérité de Control)
ViewStateIgnoresCase	Obtient une valeur qui indique si l'objet StateBag respecte la casse. (Hérité de Control)
ViewStateMode	Obtient ou définit le mode d'état d'affichage de ce contrôle. (Hérité de Control)
Visible	Obtient ou définit une valeur qui indique si un contrôle serveur est rendu en tant qu’interface utilisateur sur la page. (Hérité de Control)
Width	Obtient ou définit la largeur du contrôle serveur web. (Hérité de WebControl)

Méthodes

AddAttributesToRender(HtmlTextWriter)	Ajoute des attributs et des styles HTML qui doivent être rendus au HtmlTextWriterTag spécifié. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl)
AddedControl(Control, Int32)	Méthode appelée après qu’un contrôle enfant est ajouté à la collection Controls de l’objet Control. (Hérité de Control)
AddParsedSubObject(Object)	Avertit le contrôle serveur qu’un élément XML ou HTML a été analysé, et ajoute l’élément à l’objet ControlCollection du contrôle serveur. (Hérité de Control)
ApplyStyle(Style)	Copie tous les éléments non vides du style spécifié vers le contrôle Web, en remplaçant les éléments de style existants du contrôle. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl)
ApplyStyleSheetSkin(Page)	Applique les propriétés de style définies dans la feuille de style de la page au contrôle. (Hérité de Control)
BeginRenderTracing(TextWriter, Object)	Commence le traçage au moment du design des données de rendu. (Hérité de Control)
BuildProfileTree(String, Boolean)	Collecte des informations sur le contrôle serveur et les livre à la propriété Trace à afficher lorsque le traçage est activé pour la page. (Hérité de Control)
ClearCachedClientID()	Affecte à la valeur ClientID mise en cache la valeur null. (Hérité de Control)
ClearChildControlState()	Supprime les informations sur l'état du contrôle des contrôles enfants du contrôle serveur. (Hérité de Control)
ClearChildState()	Supprime les informations sur l'état d'affichage et sur l'état du contrôle de tous les contrôles enfants du contrôle serveur. (Hérité de Control)
ClearChildViewState()	Supprime les informations d'état d'affichage de tous les contrôles enfants du contrôle serveur. (Hérité de Control)
ClearEffectiveClientIDMode()	Affecte la valeur ClientIDMode à la propriété Inherit de l'instance de contrôle actuelle et de tous contrôles enfants. (Hérité de Control)
ConfirmInitState()	Définit l'état initialisé du contrôle lié aux données. (Hérité de BaseDataBoundControl)
CopyBaseAttributes(WebControl)	Copie les propriétés non encapsulées par l'objet Style du contrôle serveur Web spécifié vers le contrôle serveur Web à partir duquel cette méthode est appelée. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl)
CreateChildControls()	Appelée par l’infrastructure de page ASP.NET pour signaler aux contrôles serveur qu’ils doivent utiliser l’implémentation basée sur la composition pour créer les contrôles enfants qu’ils contiennent en vue de la publication ou du rendu. (Hérité de Control)
CreateControlCollection()	Crée un objet ControlCollection pour contenir les contrôles enfants (littéraux et serveur) du contrôle serveur. (Hérité de Control)
CreateControlStyle()	Crée l'objet de style qui est utilisé de manière interne par la classe WebControl pour implémenter toutes les propriétés associées au style. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl)
DataBind()	Lie une source de données au contrôle serveur appelé et à tous ses contrôles enfants. (Hérité de BaseDataBoundControl)
DataBind(Boolean)	Lie une source de données au contrôle serveur appelé et tous ses contrôles enfants avec une option pour déclencher l'événement DataBinding. (Hérité de Control)
DataBindChildren()	Lie une source de données aux contrôles enfants du contrôle serveur. (Hérité de Control)
Dispose()	Permet à un contrôle serveur d'effectuer le nettoyage final avant qu'il soit libéré de la mémoire. (Hérité de Control)
EndRenderTracing(TextWriter, Object)	Met fin au traçage au moment du design des données de rendu. (Hérité de Control)
EnsureChildControls()	Détermine si le contrôle serveur contient des contrôles enfants. S'il ne contient pas de contrôles enfants, il en crée. (Hérité de Control)
EnsureDataBound()	Appelle la méthode DataBind() si la propriété DataSourceID est définie et que le contrôle lié aux données est marqué pour demander à être lié. (Hérité de BaseDataBoundControl)
EnsureID()	Crée un identificateur pour les contrôles auxquels aucun identificateur n'est assigné. (Hérité de Control)
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
FindControl(String)	Recherche un contrôle serveur possédant le paramètre id spécifié dans le conteneur d'attribution de noms actuel. (Hérité de Control)
FindControl(String, Int32)	Recherche le conteneur d'attribution de noms actuel d'un contrôle serveur avec l'id spécifié et un entier, spécifié dans le paramètre pathOffset, qui facilite la recherche. Vous ne devez pas substituer cette version de la méthode FindControl. (Hérité de Control)
Focus()	Affecte le focus d'entrée à un contrôle. (Hérité de Control)
GetData(String)	Récupère un objet HierarchicalDataSourceView que le contrôle lié aux données utilise pour exécuter des opérations de données.
GetDataSource()	Récupère le IHierarchicalDataSource auquel le contrôle lié aux données est associé, le cas échéant.
GetDesignModeState()	Obtient les données au moment du design pour un contrôle. (Hérité de Control)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetRouteUrl(Object)	Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire. (Hérité de Control)
GetRouteUrl(RouteValueDictionary)	Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire. (Hérité de Control)
GetRouteUrl(String, Object)	Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire et à un nom d'itinéraire. (Hérité de Control)
GetRouteUrl(String, RouteValueDictionary)	Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire et à un nom d'itinéraire. (Hérité de Control)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
GetUniqueIDRelativeTo(Control)	Retourne la partie préfixée de la propriété UniqueID du contrôle spécifié. (Hérité de Control)
HasControls()	Détermine si le contrôle serveur contient des contrôles enfants. (Hérité de Control)
HasEvents()	Retourne une valeur indiquant si des événements sont inscrits pour le contrôle ou des contrôles enfants. (Hérité de Control)
IsLiteralContent()	Détermine si le contrôle serveur ne détient qu'un contenu littéral. (Hérité de Control)
LoadControlState(Object)	Restaure des informations sur l'état du contrôle à partir d'une demande de page antérieure enregistrée par la méthode SaveControlState(). (Hérité de Control)
LoadViewState(Object)	Restaure les informations d'état d'affichage d'une demande précédente enregistrée avec la méthode SaveViewState(). (Hérité de WebControl)
MapPathSecure(String)	Récupère le chemin d'accès physique auquel un chemin d'accès virtuel, absolu ou relatif, correspond. (Hérité de Control)
MarkAsDataBound()	Définit l'état du contrôle dans l'état d'affichage comme lié avec succès aux données.
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
MergeStyle(Style)	Copie tous les éléments non vides du style spécifié vers le contrôle Web, mais ne remplace aucun élément de style existant du contrôle. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl)
OnBubbleEvent(Object, EventArgs)	Détermine si l’événement du contrôle serveur est passé dans la hiérarchie des contrôles serveur de l’interface utilisateur de la page. (Hérité de Control)
OnDataBinding(EventArgs)	Déclenche l’événement DataBinding. (Hérité de Control)
OnDataBound(EventArgs)	Déclenche l’événement DataBound. (Hérité de BaseDataBoundControl)
OnDataPropertyChanged()	Appelé lorsque l'une des propriétés d'identification de la source de données de base est modifiée, pour rétablir la liaison du contrôle lié aux données à ses données.
OnDataSourceChanged(Object, EventArgs)	Appelé lorsque l'instance de IHierarchicalDataSource avec laquelle fonctionne le contrôle lié aux données déclenche l'événement DataSourceChanged.
OnInit(EventArgs)	Gère l'événement Init. (Hérité de BaseDataBoundControl)
OnLoad(EventArgs)	Gère l'événement Load.
OnPagePreLoad(Object, EventArgs)	Définit l'état initialisé du contrôle lié aux données avant que le contrôle ne soit chargé.
OnPreRender(EventArgs)	Gère l'événement PreRender. (Hérité de BaseDataBoundControl)
OnUnload(EventArgs)	Déclenche l’événement Unload. (Hérité de Control)
OpenFile(String)	Obtient un Stream utilisé pour lire un fichier. (Hérité de Control)
PerformDataBinding()	En cas de substitution dans une classe dérivée, lie des données de la source de données au contrôle.
PerformSelect()	Récupère les données de la source de données associée.
RaiseBubbleEvent(Object, EventArgs)	Assigne les sources éventuelles de l'événement et ses informations au parent du contrôle. (Hérité de Control)
RemovedControl(Control)	Méthode appelée après la suppression d’un contrôle enfant de la collection Controls de l’objet Control. (Hérité de Control)
Render(HtmlTextWriter)	Génère le rendu du contrôle via le writer HTML spécifié. (Hérité de WebControl)
RenderBeginTag(HtmlTextWriter)	Génère le rendu de la balise d'ouverture HTML du contrôle via le writer spécifié. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl)
RenderChildren(HtmlTextWriter)	Produit le contenu des enfants d'un contrôle serveur dans un objet HtmlTextWriter fourni qui écrit le contenu à restituer sur le client. (Hérité de Control)
RenderContents(HtmlTextWriter)	Génère le rendu du contenu du contrôle via le writer spécifié. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl)
RenderControl(HtmlTextWriter)	Envoie le contenu du contrôle serveur à un objet HtmlTextWriter fourni et stocke les informations de traçage sur le contrôle si le traçage est activé. (Hérité de Control)
RenderControl(HtmlTextWriter, ControlAdapter)	Génère le contenu du contrôle serveur dans un objet HtmlTextWriter à l'aide d'un objet ControlAdapter fourni. (Hérité de Control)
RenderEndTag(HtmlTextWriter)	Génère le rendu de la balise de fermeture HTML du contrôle via le writer spécifié. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl)
ResolveAdapter()	Obtient l'adaptateur de contrôles responsable du rendu du contrôle spécifié. (Hérité de Control)
ResolveClientUrl(String)	Obtient une URL qui peut être utilisée par le navigateur. (Hérité de Control)
ResolveUrl(String)	Convertit une URL en une URL que le client soit en mesure d'utiliser. (Hérité de Control)
SaveControlState()	Enregistre tous les changements d’état de contrôle serveur qui ont eu lieu depuis que la page a été publiée sur le serveur. (Hérité de Control)
SaveViewState()	Enregistre les états qui ont été modifiés après l’appel de la méthode TrackViewState(). (Hérité de WebControl)
SetDesignModeState(IDictionary)	Définit les données au moment du design pour un contrôle. (Hérité de Control)
SetRenderMethodDelegate(RenderMethod)	Assigne un délégué de gestionnaires d'événements pour générer le rendu du contrôle serveur et de son contenu dans son contrôle parent. (Hérité de Control)
SetTraceData(Object, Object)	Définit les données de trace pour le suivi du rendu des données au moment du design à l'aide de la clé des données de trace et de la valeur des données de trace. (Hérité de Control)
SetTraceData(Object, Object, Object)	Définit les données de trace pour le suivi du rendu des données au moment du design, à l'aide de l'objet suivi, de la clé des données de trace et de la valeur des données de trace. (Hérité de Control)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)
TrackViewState()	Force le contrôle à suivre les modifications apportées à son état d’affichage afin qu’elles puissent être stockées dans la propriété ViewState. (Hérité de WebControl)
ValidateDataSource(Object)	Vérifie que l'objet auquel un contrôle lié aux données se lie est un objet avec qui il peut fonctionner.

Événements

DataBinding	Se produit lorsque le contrôle serveur se lie à une source de données. (Hérité de Control)
DataBound	Se produit après la liaison du contrôle serveur à une source de données. (Hérité de BaseDataBoundControl)
Disposed	Se produit lorsqu'un contrôle serveur est libéré de la mémoire, ce qui constitue la dernière étape du cycle de vie d'un contrôle serveur en cas de demande d'une page ASP.NET. (Hérité de Control)
Init	Se produit lorsque le contrôle serveur est initialisé, ce qui constitue la première étape de son cycle de vie. (Hérité de Control)
Load	Se produit lorsque le contrôle serveur est chargé dans l'objet Page. (Hérité de Control)
PreRender	Se produit après le chargement de l'objet Control mais avant le rendu. (Hérité de Control)
Unload	Se produit lorsque le contrôle serveur est déchargé de la mémoire. (Hérité de Control)

Implémentations d’interfaces explicites

IAttributeAccessor.GetAttribute(String)	Obtient un attribut du contrôle Web avec le nom spécifié. (Hérité de WebControl)
IAttributeAccessor.SetAttribute(String, String)	Affecte au nom et à la valeur spécifiés un attribut du contrôle Web. (Hérité de WebControl)
IControlBuilderAccessor.ControlBuilder	Pour obtenir une description de ce membre, consultez ControlBuilder. (Hérité de Control)
IControlDesignerAccessor.GetDesignModeState()	Pour obtenir une description de ce membre, consultez GetDesignModeState(). (Hérité de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Pour obtenir une description de ce membre, consultez SetDesignModeState(IDictionary). (Hérité de Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Pour obtenir une description de ce membre, consultez SetOwnerControl(Control). (Hérité de Control)
IControlDesignerAccessor.UserData	Pour obtenir une description de ce membre, consultez UserData. (Hérité de Control)
IDataBindingsAccessor.DataBindings	Pour obtenir une description de ce membre, consultez DataBindings. (Hérité de Control)
IDataBindingsAccessor.HasDataBindings	Pour obtenir une description de ce membre, consultez HasDataBindings. (Hérité de Control)
IExpressionsAccessor.Expressions	Pour obtenir une description de ce membre, consultez Expressions. (Hérité de Control)
IExpressionsAccessor.HasExpressions	Pour obtenir une description de ce membre, consultez HasExpressions. (Hérité de Control)
IParserAccessor.AddParsedSubObject(Object)	Pour obtenir une description de ce membre, consultez AddParsedSubObject(Object). (Hérité de Control)

Méthodes d’extension

EnablePersistedSelection(BaseDataBoundControl)	Obsolète. Permet la conservation de la sélection dans les contrôles de données qui prennent en charge la sélection et la pagination.
FindDataSourceControl(Control)	Retourne la source de données associée au contrôle de données pour le contrôle spécifié.
FindFieldTemplate(Control, String)	Retourne le modèle de champ pour la colonne spécifiée dans le conteneur d'attribution de noms du contrôle spécifié.
FindMetaTable(Control)	Retourne l'objet Metatable pour le contrôle de données conteneur.