Control.FindControl Método

Definición

Busca el control de servidor especificado en el contenedor de nomenclatura actual.Searches the current naming container for the specified server control.

Sobrecargas

FindControl(String)

Busca un control de servidor con el parámetro id especificado en el contenedor de nomenclatura actual.Searches the current naming container for a server control with the specified id parameter.

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.Searches the current naming container for a server control with the specified id and an integer, specified in the pathOffset parameter, which aids in the search. Esta versión del método FindControl no se debe reemplazar.You should not override this version of the FindControl method.

FindControl(String)

Busca un control de servidor con el parámetro id especificado en el contenedor de nomenclatura actual.Searches the current naming container for a server control with the specified id parameter.

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.The identifier for the control to be found.

Devoluciones

Control especificado, o null si el control especificado no existe.The specified control, or null if the specified control does not exist.

Ejemplos

En el ejemplo siguiente se define un controlador de eventos Button1_Click.The following example defines a Button1_Click event handler. Cuando se invoca, este controlador usa el método FindControl para buscar un control con una propiedad ID de TextBox2 en la página contenedora.When invoked, this handler uses the FindControl method to locate a control with an ID property of TextBox2 on the containing page. Si se encuentra el control, su elemento primario se determina mediante la propiedad Parent y el ID del control primario se escribe en la página.If the control is found, its parent is determined using the Parent property and the parent control's ID is written to the page. Si no se encuentra TextBox2, "no se encuentra el control" se escribe en la página.If TextBox2 is not found, "Control Not Found" is written to the page.

Importante

Este ejemplo tiene un cuadro de texto que acepta datos proporcionados por el usuario, lo que puede suponer una amenaza para la seguridad.This example has a text box that accepts user input, which is a potential security threat. De forma predeterminada, ASP.NET Web Pages valida que los datos proporcionados por el usuario no incluyen elementos HTML ni de script.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Para más información, consulte Información general sobre los ataques mediante scripts.For more information, see Script Exploits Overview.

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 tener acceso a un control desde una función de una página de código subyacente, para tener acceso a un control que está dentro de otro contenedor o en otras circunstancias en las que el control de destino no es directamente accesible para el llamador.Use FindControl to access a control from a function in a code-behind page, to access a control that is inside another container, or in other circumstances where the target control is not directly accessible to the caller. Este método buscará un control solo si el control está incluido directamente en el contenedor especificado; es decir, el método no busca en toda una jerarquía de controles dentro de controles.This method will find a control only if the control is directly contained by the specified container; that is, the method does not search throughout a hierarchy of controls within controls. Para obtener información sobre cómo buscar un control cuando no se conoce su contenedor inmediato, vea cómo: Obtener acceso a los controles de servidor por identificador.For information about how to find a control when you do not know its immediate container, see How to: Access Server Controls by ID.

Consulte también:

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.Searches the current naming container for a server control with the specified id and an integer, specified in the pathOffset parameter, which aids in the search. Esta versión del método FindControl no se debe reemplazar.You should not override this version of the FindControl method.

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.The identifier for the control to be found.

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.The number of controls up the page control hierarchy needed to reach a naming container.

Devoluciones

Control especificado, o null si el control especificado no existe.The specified control, or null if the specified control does not exist.

Se aplica a