Accueil Library Formation Téléchargements Support technique Communauté
Connexion | United States - English | |
Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte.
Traduction
Source
Ce sujet n'a pas encore été évalué - Évaluez ce sujet

Control.EnsureChildControls, méthode

.NET Framework 4

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)
C#
C++
F#
VB
Copier 
protected virtual void 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.

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

Le contrôle GridView est un exemple de contrôle composite. Il crée des contrôles enfants tels que Table, TableRow, TableCell, Label et TextBox, utilisés pour restituer le tableau HTML généré par GridView.

Dans la plupart des cas, les développeurs de contrôles serveur personnalisés ne sont pas tenus de substituer cette méthode. Si vous substituez cette méthode, utilisez-la d'une façon semblable au 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é Note de sécurité

Cet exemple a une zone de texte qui accepte l'entrée d'utilisateur, ce qui constitue une menace éventuelle 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 ni d'éléments HTML. Pour plus d'informations, consultez Vue d'ensemble des attaques de script.

C#
VB
Copier 

       // 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();
           }
        }

.NET Framework

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

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.
Cela vous a-t-il été utile ?
(1500 caractères restants)
Contenu de la communauté Ajouter
Annotations FAQ
Microsoft réalise une enquête en ligne pour recueillir votre opinion sur le site Web de MSDN. Si vous choisissez d’y participer, cette enquête en ligne vous sera présentée lorsque vous quitterez le site Web de MSDN.

Si vous souhaitez y participer,
Confidentialité