Control.FindControl Metodo

Definizione

Spazio dei nomi:

System.Web.UI

Assembly:

System.Web.dll

Cerca nel contenitore di denominazione corrente il controllo server specificato.

Overload

Nome	Descrizione
FindControl(String)	Cerca nel contenitore di denominazione corrente un controllo server con il parametro specificato id .
FindControl(String, Int32)	Cerca nel contenitore di denominazione corrente un controllo server con l'oggetto specificato id e un numero intero, specificato nel pathOffset parametro , che facilita la ricerca. Non è consigliabile eseguire l'override di questa versione del FindControl metodo .

FindControl(String)

Cerca nel contenitore di denominazione corrente un controllo server con il parametro specificato 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

Parametri

id

String

Identificatore del controllo da trovare.

Restituisce

Control

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, "Control Not Found" (Controllo non trovato) viene scritto nella pagina.

Importante

In questo esempio è presente una casella di testo che accetta l'input dell'utente, che rappresenta una potenziale minaccia per la sicurezza. Per impostazione predefinita, ASP.NET pagine Web verificare che l'input dell'utente non includa elementi SCRIPT o HTML. Per altre informazioni, vedere Cenni preliminari sugli exploit di 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 ricerche 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 l'oggetto specificato id e un numero intero, specificato nel pathOffset parametro , che facilita la ricerca. Non è consigliabile eseguire l'override di questa versione del FindControl metodo .

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 trovare.

pathOffset

Int32

Numero di controlli per la gerarchia dei controlli pagina necessari per raggiungere un contenitore di denominazione.

Restituisce

Control

Controllo specificato oppure null se il controllo specificato non esiste.