Control.FindControl Método

Definición

Espacio de nombres:

System.Web.UI

Ensamblado:

System.Web.dll

Busca en el contenedor de nomenclatura actual el control de servidor especificado.

Sobrecargas

Nombre	Description
FindControl(String)	Busca en el contenedor de nomenclatura actual un control de servidor con el parámetro especificado id .
FindControl(String, Int32)	Busca en el contenedor de nomenclatura actual un control de servidor con el especificado id y un entero, especificado en el pathOffset parámetro , que ayuda en la búsqueda. No debe invalidar esta versión del FindControl método.

FindControl(String)

Busca en el contenedor de nomenclatura actual un control de servidor con el 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

Identificador del control que se va a encontrar.

Devoluciones

Control

Control especificado o null si el control especificado no existe.

Ejemplos

En el ejemplo siguiente se define un Button1_Click controlador de eventos. Cuando se invoca, este controlador usa el FindControl método para buscar un control con una ID propiedad de TextBox2 en la página contenedora. Si se encuentra el control, su elemento primario se determina mediante la Parent propiedad y el control ID primario se escribe en la página. Si TextBox2 no se encuentra, se escribe "Control no encontrado" en la página.

Importante

Este ejemplo tiene un cuadro de texto que acepta la entrada del usuario, que es una amenaza de seguridad potencial. De forma predeterminada, ASP.NET páginas web validan que la entrada del usuario no incluye elementos HTML ni de script. Para obtener más información, consulte Información general sobre vulnerabilidades de seguridad 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

Comentarios

Use FindControl para acceder a un control desde una función en una página de código subyacente, para acceder a un control que está dentro de otro contenedor o en otras circunstancias en las que el control de destino no sea accesible directamente para el autor de la llamada. Este método solo encontrará un control si el control está incluido directamente en el contenedor especificado; es decir, el método no busca en una jerarquía de controles dentro de los controles. Para obtener información sobre cómo buscar un control cuando no conoce su contenedor inmediato, consulte Cómo: Acceder a controles de servidor por identificador.

Consulte también

• Cómo: Acceder a controles de servidor por identificador

FindControl(String, Int32)

Busca en el contenedor de nomenclatura actual un control de servidor con el especificado id y un entero, especificado en el pathOffset parámetro , que ayuda en la búsqueda. No debe invalidar esta versión del 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

Identificador del control que se va a encontrar.

pathOffset

Int32

Número de controles de la jerarquía de controles de página necesarios para llegar a un contenedor de nomenclatura.

Devoluciones

Control

Control especificado o null si el control especificado no existe.