Page.SetFocus Método

Definición

Espacio de nombres:: System.Web.UI

Ensamblado:: System.Web.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Establece el foco del explorador en el control especificado.

Sobrecargas

Nombre	Description
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 se va a recibir el foco.

Excepciones

ArgumentNullException

control es null.

InvalidOperationException

SetFocus(Control) se llama cuando el control no forma parte de una página de formularios Web Forms.

O bien

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

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

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

Note

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

Identificador del control en el que se va a establecer el foco.

Excepciones

ArgumentNullException

clientID es null.

InvalidOperationException

SetFocus(String) se llama cuando el control no forma parte de una página de formularios Web Forms.

O bien

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

Ejemplos

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

Importante

<%@ 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 muestra 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 la representación en el cliente en el PreRender evento .

Note

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

Se aplica a

Comentarios

¿Le ha resultado útil esta página?