Control.FindControl Méthode

Définition

Espace de noms:

System.Web.UI

Assembly:

System.Web.dll

Recherche le conteneur d’affectation de noms actuel pour le contrôle serveur spécifié.

Surcharges

Nom	Description
FindControl(String)	Recherche le conteneur d’affectation de noms actuel pour un contrôle serveur avec le paramètre spécifié id .
FindControl(String, Int32)	Recherche dans le conteneur d’affectation de noms actuel un contrôle serveur avec l’entier spécifié id et spécifié dans le pathOffset paramètre, ce qui facilite la recherche. Vous ne devez pas remplacer cette version de la FindControl méthode.

FindControl(String)

Recherche le conteneur d’affectation de noms actuel pour un contrôle serveur avec le paramètre spécifié id .

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 à trouver.

Retours

Control

Le contrôle spécifié ou null si le contrôle spécifié 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 la page contenante. Si le contrôle est trouvé, son parent est déterminé à l’aide ID de la Parent propriété et le contrôle parent est écrit dans la page. S’il TextBox2 est introuvable, « Contrôle introuvable » est écrit dans la page.

Important

Cet exemple contient une zone de texte qui accepte l’entrée utilisateur, qui est une menace de sécurité potentielle. Par défaut, ASP.NET pages web valident que l’entrée utilisateur n’inclut pas de script ou d’éléments HTML. Pour plus d’informations, consultez Vue d’ensemble des exploits 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 trouve un contrôle uniquement 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 de serveur par ID

FindControl(String, Int32)

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

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 à trouver.

pathOffset

Int32

Nombre de contrôles de la hiérarchie des contrôles de page nécessaires pour atteindre un conteneur d’affectation de noms.

Retours

Control

Le contrôle spécifié ou null si le contrôle spécifié n’existe pas.