Control.FindControl Metodo

Definizione

Spazio dei nomi:

System.Web.UI

Assembly:

System.Web.dll

Cerca il controllo server specificato nel contenitore dei nomi corrente.

Overload

FindControl(String)	Cerca un controllo server nel contenitore dei nomi corrente con il parametro id specificato.
FindControl(String, Int32)	Cerca nel contenitore di denominazione corrente un controllo server con il parametro id indicato e un intero, specificato nel parametro pathOffset, che agevola la ricerca. Non eseguire l'override di questa versione del metodo FindControl.

FindControl(String)

Cerca un controllo server nel contenitore dei nomi corrente con il parametro id specificato.

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

Parametri

id

String

Identificatore del controllo da ricercare.

Restituisce

Control

Il controllo specificato oppure null se il controllo specificato non esiste.

Esempio

Nell'esempio seguente viene definito un Button1_Click gestore eventi. Quando viene richiamato, questo gestore usa il FindControl metodo per individuare un controllo con una ID proprietà di TextBox2 nella pagina contenitore. Se il controllo viene trovato, il relativo elemento padre viene determinato utilizzando la Parent proprietà e il controllo ID padre viene scritto nella pagina. Se TextBox2 non viene trovato, nella pagina viene scritto "Control Not Found".

Importante

L'esempio include una casella di testo che accetta l'input dell'utente e rappresenta quindi una potenziale minaccia alla sicurezza. Per impostazione predefinita, le pagine Web ASP.NET verificano che l'input dell'utente non includa script o elementi HTML. Per altre informazioni, vedere Cenni preliminari sugli attacchi tramite 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

Commenti

Usare FindControl per accedere a un controllo da una funzione in una pagina code-behind, per accedere a un controllo all'interno di un altro contenitore o in altre circostanze in cui il controllo di destinazione non è direttamente accessibile al chiamante. Questo metodo troverà un controllo solo se il controllo è contenuto direttamente dal contenitore specificato; ovvero, il metodo non esegue la ricerca in una gerarchia di controlli all'interno dei controlli. Per informazioni su come trovare un controllo quando non si conosce il relativo contenitore immediato, vedere Procedura: Accedere ai controlli server in base all'ID.

Vedi anche

• Procedura: Accedere ai controlli server in base all'ID

FindControl(String, Int32)

Cerca nel contenitore di denominazione corrente un controllo server con il parametro id indicato e un intero, specificato nel parametro pathOffset, che agevola la ricerca. Non eseguire l'override di questa versione del metodo 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

Parametri

id

String

Identificatore del controllo da ricercare.

pathOffset

Int32

Numero di controlli ai livelli superiori della gerarchia dei controlli della pagina necessari per raggiungere un contenitore dei nomi.

Restituisce

Control

Il controllo specificato oppure null se il controllo specificato non esiste.