Cette documentation est archivée et n’est pas conservée.

Control.EnsureChildControls, méthode

Mise à jour : novembre 2007

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.

Espace de noms :  System.Web.UI
Assembly :  System.Web (dans System.Web.dll)

protected virtual void EnsureChildControls()
protected void EnsureChildControls()
protected function EnsureChildControls()

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

ASP.NET appelle cette méthode lorsqu'il doit s'assurer que des contrôles enfants ont été créés. Dans la plupart des cas, les développeurs de contrôles serveur personnalisés ne sont pas tenus de substituer cette méthode. En cas de substitution, utilisez la méthode conformément à son comportement par défaut.

L'exemple suivant utilise la méthode EnsureChildControls pour garantir que le contrôle serveur en cours possède des contrôles enfants. Ensuite, il obtient ou définit une propriété Text pour un contrôle Web TextBox enfant dans l'objet ControlCollection du contrôle serveur en cours.

Note de sécurité :

Cet exemple comprend une zone de texte qui accepte les entrées 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 la page 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.
/** @property 
 */
public int get_Value()
{
    this.EnsureChildControls();
    return Int32.Parse(((TextBox)(get_Controls().get_Item(1))).get_Text());
} //get_Value

/** @property 
 */
public void set_Value(int value)
{
    this.EnsureChildControls();
    ((TextBox)get_Controls().get_Item(1)).set_Text(((Int32)value).ToString());
} //set_Value


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

 public function set Value(value : int)
 {
        this.EnsureChildControls();
        TextBox(Controls[1]).Text = value.ToString();
 }


Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0, 1.1, 1.0
Afficher: