Control.EnsureChildControls Méthode

Définition

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.

protected:
 virtual void EnsureChildControls();
protected virtual void EnsureChildControls ();
abstract member EnsureChildControls : unit -> unit
override this.EnsureChildControls : unit -> unit
Protected Overridable Sub EnsureChildControls ()

Exemples

L’exemple suivant utilise la EnsureChildControls méthode pour s’assurer que le contrôle serveur actuel a des contrôles enfants. Il obtient ou définit ensuite une Text propriété pour un contrôle Web enfant TextBox dans l’objet du ControlCollection contrôle serveur actuel.

Important

Cet exemple comprend une zone de texte qui accepte une entrée d'utilisateur, ce qui constitue une menace potentielle pour la sécurité. Par défaut, les pages web ASP.NET vérifient que l’entrée d’utilisateur n’inclut pas de script ou d’éléments HTML. Pour plus d’informations, consultez Vue d’ensemble des attaques de script.

// Ensure the current control has children,
// then get or set the Text property.
 public int Value {
    get {
        this.EnsureChildControls();
        return Int32.Parse(((TextBox)Controls[1]).Text);
    }
    set {
        this.EnsureChildControls();
        ((TextBox)Controls[1]).Text = value.ToString();
    }
 }

' Ensure the current control has children,
' then get or set the Text property.

Public Property Value() As Integer
   Get
      Me.EnsureChildControls()
      Return Int32.Parse(CType(Controls(1), TextBox).Text)
   End Get
   Set
      Me.EnsureChildControls()
      CType(Controls(1), TextBox).Text = value.ToString()
   End Set
End Property


Remarques

Cette méthode vérifie d’abord la valeur actuelle de la ChildControlsCreated propriété . Si cette valeur est false, la CreateChildControls méthode est appelée.

La EnsureChildControls méthode est généralement utilisée dans les contrôles composites, qui sont des contrôles qui utilisent des contrôles enfants pour une partie ou l’ensemble de leurs fonctionnalités. La EnsureChildControls méthode est appelée afin de s’assurer que les contrôles enfants ont été créés et sont prêts à traiter l’entrée, à effectuer une liaison de données ou à effectuer d’autres tâches.

Le GridView contrôle est un exemple de contrôle composite. Il crée des contrôles enfants tels que , , Label, et TextBox des contrôles, qui sont utilisés pour afficher la table HTML généréeGridView. TableCellTableRowTable

Dans la plupart des cas, les développeurs de contrôle de serveur personnalisé n’ont pas besoin de remplacer cette méthode. Si vous remplacez cette méthode, utilisez-la d’une manière similaire au comportement par défaut.

S’applique à

Voir aussi