Control.FindControl Méthode

Définition

Espace de noms:

System.Web.UI

Assembly:

System.Web.dll

Recherche le contrôle serveur spécifié dans le conteneur d'attribution de noms en cours.

Surcharges

FindControl(String)	Recherche un contrôle serveur possédant le paramètre id spécifié dans le conteneur d'attribution de noms actuel.
FindControl(String, Int32)	Recherche le conteneur d'attribution de noms actuel d'un contrôle serveur avec l'id spécifié et un entier, spécifié dans le paramètre pathOffset, qui facilite la recherche. Vous ne devez pas substituer cette version de la méthode FindControl.

FindControl(String)

Recherche un contrôle serveur possédant le paramètre id spécifié dans le conteneur d'attribution de noms actuel.

public:
 virtual System::Web::UI::Control ^ FindControl(System::String ^ id);

public virtual System.Web.UI.Control FindControl (string id);

abstract member FindControl : string -> System.Web.UI.Control
override this.FindControl : string -> System.Web.UI.Control

Public Overridable Function FindControl (id As String) As Control

Paramètres

id

String

Identificateur du contrôle à rechercher.

Retours

Control

Contrôle spécifié, ou null s'il n'existe pas.

Exemples

L’exemple suivant définit un gestionnaire d’événements Button1_Click . Lorsqu’il est appelé, ce gestionnaire utilise la FindControl méthode pour localiser un contrôle avec une ID propriété de TextBox2 sur la page contenante. Si le contrôle est trouvé, son parent est déterminé à l’aide de la Parent propriété et celui du ID contrôle parent est écrit dans la page. Si TextBox2 est introuvable, « Contrôle introuvable » est écrit dans la page.

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.

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");
      }
}

Private Sub Button1_Click(sender As Object, MyEventArgs As EventArgs)
' Find control on page.
Dim myControl1 As Control = FindControl("TextBox2")
If (Not myControl1 Is Nothing)
   ' Get control's parent.
   Dim myControl2 As Control = myControl1.Parent
   Response.Write("Parent of the text box is : " & myControl2.ID)
Else
   Response.Write("Control not found.....")
End If
End Sub

Remarques

Permet FindControl d’accéder à un contrôle à partir d’une fonction dans une page code-behind, d’accéder à un contrôle qui se trouve à 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 ne trouve un contrôle que si le contrôle est directement contenu par le conteneur spécifié ; autrement dit, la méthode ne recherche pas dans une hiérarchie de contrôles au sein des contrôles. Pour plus d’informations sur la recherche d’un contrôle lorsque vous ne connaissez pas son conteneur immédiat, consultez Guide pratique pour accéder aux contrôles serveur par ID.

Voir aussi

• Guide pratique pour accéder aux contrôles serveur par ID

FindControl(String, Int32)

Recherche le conteneur d'attribution de noms actuel d'un contrôle serveur avec l'id spécifié et un entier, spécifié dans le paramètre pathOffset, qui facilite la recherche. Vous ne devez pas substituer cette version de la méthode FindControl.

protected:
 virtual System::Web::UI::Control ^ FindControl(System::String ^ id, int pathOffset);

protected virtual System.Web.UI.Control FindControl (string id, int pathOffset);

abstract member FindControl : string * int -> System.Web.UI.Control
override this.FindControl : string * int -> System.Web.UI.Control

Protected Overridable Function FindControl (id As String, pathOffset As Integer) As Control

Paramètres

id

String

Identificateur du contrôle à rechercher.

pathOffset

Int32

Nombre de contrôles en haut de la hiérarchie des contrôles de la page nécessaires pour atteindre un conteneur d'attribution de noms.

Retours

Control

Contrôle spécifié, ou null s'il n'existe pas.