Control.EnsureChildControls Méthode
Définition
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.
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 -> unitProtected Overridable Sub EnsureChildControls ()Exemples
L’exemple suivant utilise la EnsureChildControls méthode pour vous assurer que le contrôle de 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 certaines ou toutes leurs fonctionnalités. La EnsureChildControls méthode est appelée pour vous assurer que les contrôles enfants ont été créés et sont prêts à traiter les entrées, à 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 queTable, , , TableRowTableCell, Labelet TextBox des contrôles, qui sont utilisés pour afficher la table HTML généréeGridView.
Dans la plupart des cas, les développeurs de contrôle de serveur personnalisé n’ont pas à remplacer cette méthode. Si vous remplacez cette méthode, utilisez-la de manière similaire au comportement par défaut.