Control.FindControl Método

Definição

Namespace:

System.Web.UI

Assembly:

System.Web.dll

Pesquisa o contêiner de nomenclatura atual para o controle de servidor especificado.

Sobrecargas

FindControl(String)	Procura o atual contêiner de nomenclatura de um controle de servidor com o parâmetro id especificado.
FindControl(String, Int32)	Procura o contêiner de nomenclatura atual para um controle de servidor com o id especificado e um inteiro especificado no parâmetro pathOffset, que auxilia na pesquisa. Você não deve substituir esta versão do método FindControl.

FindControl(String)

Procura o atual contêiner de nomenclatura de um controle de servidor com o parâmetro id especificado.

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

id

String

O identificador do controle a ser encontrado.

Retornos

Control

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.

Importante

Este exemplo tem uma caixa de texto que aceita a entrada do usuário, que é uma possível ameaça à segurança. Por padrão, ASP.NET páginas da Web validam que a entrada do usuário não inclui elementos html ou script. Para obter mais informações, consulte Visão geral de explorações 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

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

FindControl(String, Int32)

Procura o contêiner de nomenclatura atual para um controle de servidor com o id especificado e um inteiro especificado no parâmetro pathOffset, que auxilia na pesquisa. Você não deve substituir esta versão do método 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

Parâmetros

id

String

O identificador do controle a ser encontrado.

pathOffset

Int32

O número de controles da hierarquia de controle de página necessário para alcançar um contêiner de nomenclatura.

Retornos

Control

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