Control.FindControl Método

Definición

Espacio de nombres:

System.Web.UI

Ensamblado:

System.Web.dll

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

Sobrecargas

FindControl(String)	Busca un control de servidor con el parámetro id especificado en el contenedor de nomenclatura actual.
FindControl(String, Int32)	Busca el contenedor de nomenclatura actual para un control de servidor con el id especificado y un entero, que se especifica en el parámetro pathOffset, que ayuda a realizar la búsqueda. Esta versión del método FindControl no se debe reemplazar.

FindControl(String)

Busca un control de servidor con el parámetro id especificado en el contenedor de nomenclatura actual.

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

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 datos proporcionados por el usuario, lo que puede suponer una amenaza para la seguridad. De forma predeterminada, ASP.NET Web Pages valida que los datos proporcionados por el usuario no incluyen elementos HTML ni de script. Para más información, consulte Información general sobre los ataques mediante 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

Comentarios

Use FindControl para acceder a un control desde una función de 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 directamente accesible para el autor de la llamada. Este método encontrará un control solo 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, vea Cómo: Obtener acceso a los controles de servidor por identificador.

Consulte también

• Cómo: Obtener acceso a controles de servidor por identificador

FindControl(String, Int32)

Busca el contenedor de nomenclatura actual para un control de servidor con el id especificado y un entero, que se especifica en el parámetro pathOffset, que ayuda a realizar la búsqueda. Esta versión del método FindControl no se debe reemplazar.

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

pathOffset

Int32

Número de controles situados más arriba en la jerarquía de controles de la página necesario para llegar a un contenedor de nomenclatura.

Devoluciones

Control

Control especificado, o null si el control especificado no existe.