Control.FindControl Método

Definição

Espaço de Nomes:
System.Web.UI
Assemblagem:
System.Web.dll

Pesquisa no contentor atual de nomenclatura o controlo do servidor especificado.

Sobrecargas

Name Description
FindControl(String)

Procura no contentor de nomenclatura atual um controlo de servidor com o parâmetro especificado id .
FindControl(String, Int32)

Pesquisa no contentor de nomenclatura atual um controlo de servidor com o especificado id e um inteiro, especificados no pathOffset parâmetro, o que auxilia na pesquisa. Não deve sobrepor-se a esta versão do FindControl método.

FindControl(String)

Procura no contentor de nomenclatura atual um controlo de servidor com o parâmetro especificado 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

Parâmetros

id
String

O identificador do controlo a encontrar.

Devoluções

Control

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

Exemplos

O exemplo seguinte define um Button1_Click gestor de eventos. Quando invocado, este handler usa o FindControl método para localizar um controlo com uma ID propriedade de TextBox2 na página que contém. Se o controlo for encontrado, o seu pai é determinado usando a Parent propriedade e o do controlo ID do pai é escrito na página. Se TextBox2 não for encontrado, "Control Não Encontrado" é escrito na página.

Importante

Este exemplo tem uma caixa de texto que aceita a entrada do utilizador, o que constitui uma potencial ameaça à segurança. Por defeito, as páginas Web do ASP.NET validam que a entrada do utilizador não inclui elementos de script ou HTML. Para mais informações, consulte Visão Geral dos Exploits de Scripts.

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

Observações

Use FindControl para aceder a um controlo a partir de uma função numa página code-behind, para aceder a um controlo que esteja dentro de outro contentor, ou noutras circunstâncias em que o controlo alvo não seja diretamente acessível ao chamador. Este método só encontrará um controlo se o controlo estiver diretamente contido pelo recipiente especificado; ou seja, o método não procura ao longo de uma hierarquia de controlos dentro de controlos. Para informações sobre como encontrar um controlo quando não conhece o seu contentor imediato, veja Como: Aceder aos Controlos do Servidor por ID.

Ver também

Aplica-se a

FindControl(String, Int32)

Pesquisa no contentor de nomenclatura atual um controlo de servidor com o especificado id e um inteiro, especificados no pathOffset parâmetro, o que auxilia na pesquisa. Não deve sobrepor-se a esta versão do FindControl método.

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 controlo a encontrar.

pathOffset
Int32

O número de controlos na hierarquia de controlo de página necessário para chegar a um contentor de nomenclatura.

Devoluções

Control

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

Aplica-se a