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

Control.EnsureChildControls, méthode

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.

// 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 98, Windows 2000 SP4, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0
Afficher: