Page.SetFocus Método

Definição

Espaço de Nomes:: System.Web.UI

Assemblagem:: System.Web.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Define o foco do navegador para o controlo especificado.

Sobrecargas

Name	Description
SetFocus(Control)	Define o foco do navegador para o controlo especificado.
SetFocus(String)	Define o foco do navegador para o controlo com o identificador especificado.

SetFocus(Control)

Define o foco do navegador para o controlo 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 controlo para receber foco.

Exceções

ArgumentNullException

control é null.

InvalidOperationException

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

-ou-

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

Exemplos

O exemplo de código seguinte coloca o foco na segunda caixa de texto numa página Web.

Importante

Este exemplo tem uma caixa de texto que aceita a entrada do utilizador, o que constitui uma potencial ameaça à segurança. Por defeito, as páginas Web do ASP.NET validam que a entrada do utilizador não inclui elementos de script ou HTML. Para mais informações, consulte Visão Geral dos Exploits de 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>

Observações

Use o SetFocus método para tornar o controlo especificado o controlo ativo na página Web apresentada pelo navegador. O SetFocus método deve ser chamado antes de a página ser preparada para ser apresentada ao cliente no PreRender evento.

Note

O SetFocus método funcionará apenas em navegadores que suportem ECMAScript versão 1.3 ou posterior.

Aplica-se a

SetFocus(String)

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

O ID do controlo para definir o foco.

Exceções

ArgumentNullException

clientID é null.

InvalidOperationException

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

-ou-

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

Exemplos

O exemplo de código seguinte coloca o foco na segunda caixa de texto numa 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>

Observações

Use o SetFocus método para tornar o controlo com a string ID especificada o controlo ativo na página Web apresentada pelo navegador. O SetFocus método deve ser chamado antes de a página ser preparada para ser apresentada ao cliente no PreRender evento.

Note

O SetFocus método funcionará apenas em navegadores que suportem ECMAScript versão 1.3 ou posterior.

Aplica-se a

Comentários

Esta página foi útil?