Page.SetFocus Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI
Zestaw:
System.Web.dll

Ustawia fokus przeglądarki na określoną kontrolkę.

Przeciążenia

SetFocus(Control)

Ustawia fokus przeglądarki na określoną kontrolkę.
SetFocus(String)

Ustawia fokus przeglądarki na kontrolkę z określonym identyfikatorem.

SetFocus(Control)

Ustawia fokus przeglądarki na określoną kontrolkę.

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

Kontrolka do odbierania fokusu.

Wyjątki

ArgumentNullException

control to null.

InvalidOperationException

SetFocus(Control)jest wywoływany, gdy kontrolka nie jest częścią strony Web Forms.

-lub-

SetFocus(Control) element jest wywoływany po zdarzeniu PreRender .

Przykłady

Poniższy przykład kodu ustawia fokus na drugie pole tekstowe na stronie sieci Web.

Ważne

Ten przykład zawiera pole tekstowe, które akceptuje dane wejściowe użytkownika, co jest potencjalnym zagrożeniem bezpieczeństwa. Domyślnie ASP.NET strony sieci Web sprawdzają, czy dane wejściowe użytkownika nie zawierają skryptów ani elementów HTML. Aby uzyskać więcej informacji, zobacz Script Exploits Overview (Omówienie luk w zabezpieczeniach skryptów).

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

Uwagi

SetFocus Użyj metody , aby ustawić określoną kontrolkę jako aktywną kontrolkę na stronie sieci Web wyświetlanej przez przeglądarkę. Metoda SetFocus musi zostać wywołana przed przygotowaniem strony do renderowania do klienta w zdarzeniu PreRender .

Uwaga

Metoda SetFocus będzie działać tylko w przeglądarkach obsługujących język ECMAScript w wersji 1.3 lub nowszej.

Dotyczy

SetFocus(String)

Ustawia fokus przeglądarki na kontrolkę z określonym identyfikatorem.

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

Identyfikator kontrolki, na który ma być ustawiony fokus.

Wyjątki

ArgumentNullException

clientID to null.

InvalidOperationException

SetFocus(String)jest wywoływany, gdy kontrolka nie jest częścią strony Web Forms.

-lub-

SetFocus(String) element jest wywoływany po zdarzeniu PreRender .

Przykłady

Poniższy przykład kodu ustawia fokus na drugie pole tekstowe na stronie sieci Web.

Ważne

Ten przykład zawiera pole tekstowe, które akceptuje dane wejściowe użytkownika, co jest potencjalnym zagrożeniem bezpieczeństwa. Domyślnie ASP.NET strony sieci Web sprawdzają, czy dane wejściowe użytkownika nie zawierają skryptów ani elementów HTML. Aby uzyskać więcej informacji, zobacz Script Exploits Overview (Omówienie luk w zabezpieczeniach skryptów).

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

Uwagi

SetFocus Użyj metody , aby ustawić kontrolkę za pomocą określonego ciągu identyfikatora jako aktywną kontrolkę na stronie sieci Web wyświetlanej przez przeglądarkę. Metoda SetFocus musi zostać wywołana przed przygotowaniem strony do renderowania do klienta w zdarzeniu PreRender .

Uwaga

Metoda SetFocus będzie działać tylko w przeglądarkach obsługujących język ECMAScript w wersji 1.3 lub nowszej.

Dotyczy