Page.SetFocus Metoda

Definice

Obor názvů:
System.Web.UI
Sestavení:
System.Web.dll

Nastaví fokus prohlížeče na zadaný ovládací prvek.

Přetížení

Name Description
SetFocus(Control)

Nastaví fokus prohlížeče na zadaný ovládací prvek.
SetFocus(String)

Nastaví fokus prohlížeče na ovládací prvek se zadaným identifikátorem.

SetFocus(Control)

Nastaví fokus prohlížeče na zadaný ovládací prvek.

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)

Parametry

control
Control

Ovládací prvek pro příjem fokusu.

Výjimky

ArgumentNullException

control je null.

InvalidOperationException

SetFocus(Control) je volána, pokud ovládací prvek není součástí stránky Webové formuláře.

nebo

SetFocus(Control) je volána po PreRender události.

Příklady

Následující příklad kódu nastaví fokus na druhé textové pole na webové stránce.

Important

Tento příklad obsahuje textové pole, které přijímá vstup uživatele, což je potenciální bezpečnostní hrozba. Ve výchozím nastavení ASP.NET webové stránky ověřují, že vstup uživatele neobsahuje skripty ani elementy HTML. Další informace naleznete v tématu Přehled zneužití skriptů.

<%@ 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>

Poznámky

Použijte metodu SetFocus , aby zadaný ovládací prvek aktivní ovládací prvek na webové stránce zobrazené prohlížečem. Metoda SetFocus musí být volána před tím, než bude stránka připravena k vykreslení klientovi PreRender v události.

Note

Metoda SetFocus bude fungovat pouze v prohlížečích podporujících ECMAScript verze 1.3 nebo novější.

Platí pro

SetFocus(String)

Nastaví fokus prohlížeče na ovládací prvek se zadaným identifikátorem.

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

Parametry

clientID
String

ID ovládacího prvku, na který chcete nastavit fokus.

Výjimky

ArgumentNullException

clientID je null.

InvalidOperationException

SetFocus(String) je volána, pokud ovládací prvek není součástí stránky Webové formuláře.

nebo

SetFocus(String) je volána po PreRender události.

Příklady

Následující příklad kódu nastaví fokus na druhé textové pole na webové stránce.

Important

Tento příklad obsahuje textové pole, které přijímá vstup uživatele, což je potenciální bezpečnostní hrozba. Ve výchozím nastavení ASP.NET webové stránky ověřují, že vstup uživatele neobsahuje skripty ani elementy HTML. Další informace naleznete v tématu Přehled zneužití skriptů.

<%@ 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>

Poznámky

SetFocus Metoda slouží k vytvoření ovládacího prvku se zadaným řetězcem ID aktivní ovládací prvek na webové stránce zobrazené prohlížečem. Metoda SetFocus musí být volána před tím, než bude stránka připravena k vykreslení klientovi PreRender v události.

Note

Metoda SetFocus bude fungovat pouze v prohlížečích podporujících ECMAScript verze 1.3 nebo novější.

Platí pro