Page.SetFocus Método

  • Referencia

Definición

Espacio de nombres:
System.Web.UI
Ensamblado:
System.Web.dll

Establece el foco del explorador en el control especificado.

Sobrecargas

SetFocus(Control)

Establece el foco del explorador en el control especificado.
SetFocus(String)

Establece el foco del explorador en el control con el identificador especificado.

SetFocus(Control)

Establece el foco del explorador en el control especificado.

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

Parámetros

control
Control

Control que recibirá el foco.

Excepciones

ArgumentNullException

control es null.

InvalidOperationException

Cuando el control no forma parte de una página de formularios Web Forms, se llama al método SetFocus(Control).

o bien

Se llama a SetFocus(Control) después del evento PreRender.

Ejemplos

En el ejemplo de código siguiente se establece el foco en el segundo cuadro de texto de una página web.

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.

<%@ 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 método para convertir el SetFocus control especificado en el control activo en la página web que muestra el explorador. Se SetFocus debe llamar al método antes de que la página esté preparada para su representación en el cliente en el PreRender evento .

Nota

El SetFocus método solo funcionará en exploradores compatibles con ECMAScript versión 1.3 o posterior.

Se aplica a

SetFocus(String)

Establece el foco del explorador en el control con el identificador especificado.

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

Id. del control en el que se establece el foco.

Excepciones

ArgumentNullException

clientID es null.

InvalidOperationException

Cuando el control no forma parte de una página de formularios Web Forms, se llama al método SetFocus(String).

o bien

Se llama a SetFocus(String) después del evento PreRender.

Ejemplos

En el ejemplo de código siguiente se establece el foco en el segundo cuadro de texto de una página web.

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.

<%@ 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 método para convertir el SetFocus control con la cadena de identificador especificada que el control activo en la página web muestra el explorador. Se SetFocus debe llamar al método antes de que la página esté preparada para su representación en el cliente en el PreRender evento .

Nota

El SetFocus método solo funcionará en exploradores compatibles con ECMAScript versión 1.3 o posterior.

Se aplica a