Page.SetFocus Méthode

  • Référence

Définition

Espace de noms:
System.Web.UI
Assembly:
System.Web.dll

Affecte au focus du navigateur le contrôle spécifié.

Surcharges

SetFocus(Control)

Affecte au focus du navigateur le contrôle spécifié.
SetFocus(String)

Affecte au focus du navigateur le contrôle avec l'identificateur spécifié.

SetFocus(Control)

Affecte au focus du navigateur le contrôle spécifié.

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)

Paramètres

control
Control

Contrôle devant recevoir le focus.

Exceptions

ArgumentNullException

control a la valeur null.

InvalidOperationException

SetFocus(Control) est appelé lorsque le contrôle ne fait pas partie d'une page Web Forms.

- ou -

La méthode SetFocus(Control) est appelée après l'événement PreRender.

Exemples

L’exemple de code suivant définit le focus sur la deuxième zone de texte d’une page Web.

Important

Cet exemple comprend une zone de texte qui accepte une entrée d'utilisateur, ce qui constitue une menace potentielle pour la sécurité. Par défaut, les pages web ASP.NET vérifient que l’entrée d’utilisateur n’inclut pas de script ou d’éléments HTML. Pour plus d’informations, consultez Vue d’ensemble des attaques 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>

Remarques

Utilisez la SetFocus méthode pour que le contrôle spécifié soit le contrôle actif sur la page Web affichée par le navigateur. La SetFocus méthode doit être appelée avant que la page ne soit préparée pour le rendu sur le client dans l’événement PreRender .

Notes

La SetFocus méthode fonctionne uniquement sur les navigateurs prenant en charge ECMAScript version 1.3 ou ultérieure.

S’applique à

SetFocus(String)

Affecte au focus du navigateur le contrôle avec l'identificateur spécifié.

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

Paramètres

clientID
String

L'ID du contrôle à affecter au focus.

Exceptions

ArgumentNullException

clientID a la valeur null.

InvalidOperationException

SetFocus(String) est appelé lorsque le contrôle ne fait pas partie d'une page Web Forms.

- ou -

La méthode SetFocus(String) est appelée après l'événement PreRender.

Exemples

L’exemple de code suivant définit le focus sur la deuxième zone de texte d’une page Web.

Important

Cet exemple comprend une zone de texte qui accepte une entrée d'utilisateur, ce qui constitue une menace potentielle pour la sécurité. Par défaut, les pages web ASP.NET vérifient que l’entrée d’utilisateur n’inclut pas de script ou d’éléments HTML. Pour plus d’informations, consultez Vue d’ensemble des attaques 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>

Remarques

Utilisez la SetFocus méthode pour faire du contrôle avec la chaîne d’ID spécifiée le contrôle actif dans la page Web affichée par le navigateur. La SetFocus méthode doit être appelée avant que la page ne soit préparée pour le rendu sur le client dans l’événement PreRender .

Notes

La SetFocus méthode fonctionne uniquement sur les navigateurs prenant en charge ECMAScript version 1.3 ou ultérieure.

S’applique à