Control.FindControl Método

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

Parâmetros

Retornos

O controle especificado, ou null, se o controle especificado não existir.

Exemplos

O exemplo a seguir define um Button1_Click manipulador de eventos. Quando invocado, esse manipulador usa o FindControl método para localizar um controle com uma ID propriedade de TextBox2 na página que o contém. Se o controle for encontrado, seu pai será determinado usando a Parent propriedade e o do ID controle pai será gravado na página. Se TextBox2 não for encontrado, "Controle Não Encontrado" será gravado na página.

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

Comentários

Use FindControl para acessar um controle de uma função em uma página code-behind, para acessar um controle que está dentro de outro contêiner ou em outras circunstâncias em que o controle de destino não está diretamente acessível ao chamador. Esse método só encontrará um controle se o controle estiver diretamente contido pelo contêiner especificado; ou seja, o método não pesquisa em uma hierarquia de controles dentro de controles. Para obter informações sobre como encontrar um controle quando você não souber seu contêiner imediato, consulte Como acessar controles de servidor por ID.

Confira também

• Como acessar controles de servidor por ID

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

Parâmetros

Retornos

O controle especificado, ou null, se o controle especificado não existir.