Page.SetFocus Metodo

Definizione

Spazio dei nomi:
System.Web.UI
Assembly:
System.Web.dll

Imposta lo stato attivo del browser sul controllo specificato.

Overload

Nome Descrizione
SetFocus(Control)

Imposta lo stato attivo del browser sul controllo specificato.
SetFocus(String)

Imposta lo stato attivo del browser sul controllo con l'identificatore specificato.

SetFocus(Control)

Imposta lo stato attivo del browser sul controllo specificato.

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)

Parametri

control
Control

Controllo per la ricezione dello stato attivo.

Eccezioni

ArgumentNullException

control è null.

InvalidOperationException

SetFocus(Control) viene chiamato quando il controllo non fa parte di una pagina Web Form.

oppure

SetFocus(Control) viene chiamato dopo l'evento PreRender .

Esempio

Nell'esempio di codice seguente lo stato attivo viene impostato sulla seconda casella di testo di una pagina Web.

Importante

In questo esempio è presente una casella di testo che accetta l'input dell'utente, che rappresenta una potenziale minaccia per la sicurezza. Per impostazione predefinita, ASP.NET pagine Web verificare che l'input dell'utente non includa elementi SCRIPT o HTML. Per altre informazioni, vedere Cenni preliminari sugli exploit di 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>

Commenti

Utilizzare il SetFocus metodo per impostare il controllo specificato sul controllo attivo nella pagina Web visualizzata dal browser. Il SetFocus metodo deve essere chiamato prima che la pagina venga preparata per il rendering nel client nell'evento PreRender .

Note

Il SetFocus metodo funzionerà solo nei browser che supportano ECMAScript versione 1.3 o successiva.

Si applica a

SetFocus(String)

Imposta lo stato attivo del browser sul controllo con l'identificatore specificato.

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

Parametri

clientID
String

ID del controllo su cui impostare lo stato attivo.

Eccezioni

ArgumentNullException

clientID è null.

InvalidOperationException

SetFocus(String) viene chiamato quando il controllo non fa parte di una pagina Web Form.

oppure

SetFocus(String) viene chiamato dopo l'evento PreRender .

Esempio

Nell'esempio di codice seguente lo stato attivo viene impostato sulla seconda casella di testo di una pagina Web.

Importante

In questo esempio è presente una casella di testo che accetta l'input dell'utente, che rappresenta una potenziale minaccia per la sicurezza. Per impostazione predefinita, ASP.NET pagine Web verificare che l'input dell'utente non includa elementi SCRIPT o HTML. Per altre informazioni, vedere Cenni preliminari sugli exploit di 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>

Commenti

Utilizzare il SetFocus metodo per impostare il controllo con la stringa ID specificata il controllo attivo nella pagina Web visualizzata dal browser. Il SetFocus metodo deve essere chiamato prima che la pagina venga preparata per il rendering nel client nell'evento PreRender .

Note

Il SetFocus metodo funzionerà solo nei browser che supportano ECMAScript versione 1.3 o successiva.

Si applica a