Page.SetFocus Metodo

  • Riferimento

Definizione

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

Imposta lo stato attivo del browser sul controllo specificato.

Overload

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 che riceverà lo stato attivo.

Eccezioni

ArgumentNullException

control è null.

InvalidOperationException

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

-oppure-

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

Esempio

L'esempio di codice seguente imposta lo stato attivo sulla seconda casella di testo in una pagina Web.

Importante

L'esempio include una casella di testo che accetta l'input dell'utente e rappresenta quindi una potenziale minaccia alla sicurezza. Per impostazione predefinita, le pagine Web ASP.NET verificano che l'input dell'utente non includa script o elementi HTML. Per altre informazioni, vedere Cenni preliminari sugli attacchi tramite 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 rendere il controllo attivo nel controllo attivo nella pagina Web visualizzata dal browser. Il SetFocus metodo deve essere chiamato prima che la pagina sia preparata per il rendering al client nell'evento PreRender .

Nota

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 sul quale si desidera impostare lo stato attivo.

Eccezioni

ArgumentNullException

clientID è null.

InvalidOperationException

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

-oppure-

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

Esempio

L'esempio di codice seguente imposta lo stato attivo sulla seconda casella di testo in una pagina Web.

Importante

L'esempio include una casella di testo che accetta l'input dell'utente e rappresenta quindi una potenziale minaccia alla sicurezza. Per impostazione predefinita, le pagine Web ASP.NET verificano che l'input dell'utente non includa script o elementi HTML. Per altre informazioni, vedere Cenni preliminari sugli attacchi tramite 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 rendere 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 sia preparata per il rendering al client nell'evento PreRender .

Nota

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

Si applica a