Page.SetFocus Método

  • Referência

Definição

Namespace:
System.Web.UI
Assembly:
System.Web.dll

Define o foco do navegador para o controle especificado.

Sobrecargas

SetFocus(Control)

Define o foco do navegador para o controle especificado.
SetFocus(String)

Define o foco do navegador para o controle com o identificador especificado.

SetFocus(Control)

Define o foco do navegador para o controle 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

O controle a receber o foco.

Exceções

ArgumentNullException

control é null.

InvalidOperationException

SetFocus(Control) é chamado quando o controle não é parte de uma página Web Forms.

- ou -

SetFocus(Control) é chamado após o evento PreRender.

Exemplos

O exemplo de código a seguir define o foco para a segunda caixa de texto em uma página da Web.

Importante

Este exemplo tem uma caixa de texto que aceita a entrada do usuário, que é uma possível ameaça à segurança. Por padrão, ASP.NET páginas da Web validam que a entrada do usuário não inclui elementos HTML ou script. Para obter mais informações, consulte Visão geral de explorações 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>

Comentários

Use o SetFocus método para tornar o controle especificado o controle ativo na página da Web exibida pelo navegador. O SetFocus método deve ser chamado antes que a página seja preparada para renderização para o cliente no PreRender evento.

Observação

O SetFocus método funcionará somente em navegadores que dão suporte ao ECMAScript versão 1.3 ou posterior.

Aplica-se a

SetFocus(String)

Define o foco do navegador para o controle com o 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

A ID do controle para a qual o foco será definido.

Exceções

ArgumentNullException

clientID é null.

InvalidOperationException

SetFocus(String) é chamado quando o controle não é parte de uma página Web Forms.

- ou -

SetFocus(String) é chamado após o evento PreRender.

Exemplos

O exemplo de código a seguir define o foco para a segunda caixa de texto em uma página da Web.

Importante

Este exemplo tem uma caixa de texto que aceita a entrada do usuário, que é uma possível ameaça à segurança. Por padrão, ASP.NET páginas da Web validam que a entrada do usuário não inclui elementos HTML ou script. Para obter mais informações, consulte Visão geral de explorações 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.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>

Comentários

Use o SetFocus método para tornar o controle com a cadeia de caracteres de ID especificada o controle ativo na página da Web exibida pelo navegador. O SetFocus método deve ser chamado antes que a página seja preparada para renderização para o cliente no PreRender evento.

Observação

O SetFocus método funcionará somente em navegadores que dão suporte ao ECMAScript versão 1.3 ou posterior.

Aplica-se a