Page.SetFocus Metoda

  • Reference

Definice

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

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

Přetížení

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í Web Forms stránky.

-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.

Důležité

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 uživatelský vstup neobsahuje skript nebo elementy HTML. Další informace najdete 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 k vytvoření zadaného ovládacího prvku jako aktivní ovládací prvek na webové stránce zobrazené prohlížečem. Metoda SetFocus musí být volána předtím, než je stránka připravena pro vykreslení do klienta v PreRender události.

Poznámka

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ý se má fokus nastavit.

Výjimky

ArgumentNullException

clientID je null.

InvalidOperationException

SetFocus(String)je volána, pokud ovládací prvek není součástí Web Forms stránky.

-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.

Důležité

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 uživatelský vstup neobsahuje skript nebo elementy HTML. Další informace najdete 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 Pomocí metody nastavte ovládací prvek se zadaným řetězcem ID jako aktivní ovládací prvek na webové stránce zobrazené v prohlížeči. Metoda SetFocus musí být volána předtím, než je stránka připravena pro vykreslení do klienta v PreRender události.

Poznámka

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

Platí pro