Control.FindControl, méthode (String)

Utilisez FindControl pour accéder à un contrôle à partir d'une fonction dans une page code-behind, pour accéder à un contrôle situé à l'intérieur d'un autre conteneur, ou dans d'autres circonstances où le contrôle cible n'est pas directement accessible à l'appelant. Cette méthode trouve un contrôle uniquement si le contrôle est contenu directement dans le conteneur spécifié ; autrement dit, la méthode ne recherche pas partout dans une hiérarchie de contrôles à l'intérieur des contrôles. Pour plus d'informations sur la recherche d'un contrôle lorsque vous ne connaissez pas son conteneur immédiat, consultez Comment : accéder à des contrôles serveur par ID.

L'exemple suivant définit un gestionnaire d'événements Button1_Click. Ce gestionnaire, lorsqu'il est appelé, utilise la méthode FindControl pour localiser un contrôle avec une propriété IDTextBox2 sur la page conteneur. Si le contrôle est localisé, son parent est déterminé à l'aide de la propriété Parent et l'ID du contrôle parent est écrit dans la page. Si TextBox2 est introuvable, la chaîne « Control Not Found » (Contrôle introuvable) est écrite sur la page.

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.

private void Button1_Click(object sender, EventArgs MyEventArgs)
{
      // Find control on page.
      Control myControl1 = FindControl("TextBox2");
      if(myControl1!=null)
      {
         // Get control's parent.
         Control myControl2 = myControl1.Parent;
         Response.Write("Parent of the text box is : " + myControl2.ID);
      }
      else
      {
         Response.Write("Control not found");
      }
}

.NET Framework

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

Référence

Autres ressources