Page.SetFocus Méthode

Référence

Définition

Espace de noms:: System.Web.UI

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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 de la page Web affiché par le navigateur. La SetFocus méthode doit être appelée avant que la page soit préparée pour le rendu au 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

<%@ 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 soit préparée pour le rendu au 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 à

Partager via

Page.SetFocus Méthode

Définition

Surcharges

SetFocus(Control)

Paramètres

Exceptions

Exemples

Remarques

S’applique à

SetFocus(String)

Paramètres

Exceptions

Exemples

Remarques

S’applique à

Ressources supplémentaires