Page.SetFocus Page.SetFocus Page.SetFocus Page.SetFocus Method

Definición

Establece el foco del explorador en el control especificado.Sets the browser focus to the specified control.

Sobrecargas

SetFocus(Control) SetFocus(Control) SetFocus(Control)

Establece el foco del explorador en el control especificado.Sets the browser focus to the specified control.

SetFocus(String) SetFocus(String) SetFocus(String) SetFocus(String)

Establece el foco del explorador en el control con el identificador especificado.Sets the browser focus to the control with the specified identifier.

SetFocus(Control) SetFocus(Control) SetFocus(Control)

Establece el foco del explorador en el control especificado.Sets the browser focus to the specified control.

public:
 void SetFocus(System::Web::UI::Control ^ control);
public void SetFocus (System.Web.UI.Control control);
member this.SetFocus : System.Web.UI.Control -> unit

Parámetros

control
Control Control Control Control

Control que recibirá el foco.The control to receive focus.

Excepciones

Cuando el control no forma parte de una página de formularios Web Forms, se llama al método SetFocus(Control).SetFocus(Control) is called when the control is not part of a Web Forms page.

o bien-or- Se llama a SetFocus(Control) después del evento PreRender.SetFocus(Control) is called after the PreRender event.

Ejemplos

En el ejemplo de código siguiente se establece el foco en el segundo cuadro de texto de una página web.The following code example sets the focus to the second text box on a Web 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.

<%@ page language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
    void Page_Init(object sender, EventArgs e)
    {
        SetFocus(focusHere);
    }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
        <asp:textbox id="default" runat="server" /><br />
        <asp:textbox id="focusHere" runat="server" />
    </form>
</body>
</html>
<%@ page language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
    Sub Page_Init(ByVal sender As Object, ByVal e As EventArgs)
        SetFocus(focusHere)
    End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
        <asp:textbox id="default" runat="server" /><br />
        <asp:textbox id="focusHere" runat="server" />
    </form>
</body>
</html>

Comentarios

Use el SetFocus método para convertir el control especificado en el control activo en la página web que muestra el explorador.Use the SetFocus method to make the specified control the active control on the Web page displayed by the browser. Se SetFocus debe llamar al método antes de que la página esté preparada para su representación en el cliente PreRender en el evento.The SetFocus method must be called before the page is prepared for rendering to the client in the PreRender event.

Nota

El SetFocus método solo funcionará en exploradores compatibles con la versión 1,3 o posterior de ECMAScript.The SetFocus method will work only on browsers supporting ECMAScript version 1.3 or later.

SetFocus(String) SetFocus(String) SetFocus(String) SetFocus(String)

Establece el foco del explorador en el control con el identificador especificado.Sets the browser focus to the control with the specified identifier.

public:
 void SetFocus(System::String ^ clientID);
public void SetFocus (string clientID);
member this.SetFocus : string -> unit
Public Sub SetFocus (clientID As String)

Parámetros

clientID
String String String String

Id. del control en el que se establece el foco.The ID of the control to set focus to.

Excepciones

Cuando el control no forma parte de una página de formularios Web Forms, se llama al método SetFocus(String).SetFocus(String) is called when the control is not part of a Web Forms page.

O bien-or- Se llama a SetFocus(String) después del evento PreRender.SetFocus(String) is called after the PreRender event.

Ejemplos

En el ejemplo de código siguiente se establece el foco en el segundo cuadro de texto de una página web.The following code example sets the focus to the second text box on a Web 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.

<%@ page language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
    void Page_Init(object sender, EventArgs e)
    {
        SetFocus(focusHere.ClientID);
    }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
        <asp:textbox id="default" runat="server" /><br />
        <asp:textbox id="focusHere" runat="server" />
    </form>
</body>
</html>
<%@ page language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
    Sub Page_Init(ByVal sender As Object, ByVal e As EventArgs)
        SetFocus(focusHere.ClientID)
    End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
        <asp:textbox id="default" runat="server" /><br />
        <asp:textbox id="focusHere" runat="server" />
    </form>
</body>
</html>

Comentarios

Use el SetFocus método para convertir el control con la cadena de identificador especificada en el control activo de la página web que muestra el explorador.Use the SetFocus method to make the control with the specified ID string the active control in the Web page displayed by the browser. Se SetFocus debe llamar al método antes de que la página esté preparada para su representación en el cliente PreRender en el evento.The SetFocus method must be called before the page is prepared for rendering to the client in the PreRender event.

Nota

El SetFocus método solo funcionará en exploradores compatibles con la versión 1,3 o posterior de ECMAScript.The SetFocus method will work only on browsers supporting ECMAScript version 1.3 or later.

Se aplica a