Bagikan melalui

Page.SetFocus Metode

  • Referensi

Definisi

Ruang nama:
System.Web.UI
Rakitan:
System.Web.dll

Mengatur fokus browser ke kontrol yang ditentukan.

Overload

SetFocus(Control)

Mengatur fokus browser ke kontrol yang ditentukan.
SetFocus(String)

Mengatur fokus browser ke kontrol dengan pengidentifikasi yang ditentukan.

SetFocus(Control)

Mengatur fokus browser ke kontrol yang ditentukan.

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)

Parameter

control
Control

Kontrol untuk menerima fokus.

Pengecualian

ArgumentNullException

controladalah null.

InvalidOperationException

SetFocus(Control) dipanggil ketika kontrol bukan bagian dari halaman Formulir Web.

-atau-

SetFocus(Control) dipanggil setelah PreRender peristiwa.

Contoh

Contoh kode berikut mengatur fokus ke kotak teks kedua pada halaman Web.

Penting

Contoh ini memiliki kotak teks yang menerima input pengguna, yang merupakan potensi ancaman keamanan. Secara default, ASP.NET halaman Web memvalidasi bahwa input pengguna tidak menyertakan elemen skrip atau HTML. Untuk informasi selengkapnya, lihat Gambaran Umum Eksploitasi Skrip.

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

Keterangan

SetFocus Gunakan metode untuk membuat kontrol yang ditentukan kontrol aktif pada halaman Web yang ditampilkan oleh browser. Metode SetFocus harus dipanggil sebelum halaman disiapkan untuk dirender ke klien dalam peristiwa tersebut PreRender .

Catatan

Metode ini SetFocus hanya akan berfungsi pada browser yang mendukung ECMAScript versi 1.3 atau yang lebih baru.

Berlaku untuk

SetFocus(String)

Mengatur fokus browser ke kontrol dengan pengidentifikasi yang ditentukan.

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

Parameter

clientID
String

ID kontrol yang akan diatur fokusnya.

Pengecualian

ArgumentNullException

clientIDadalah null.

InvalidOperationException

SetFocus(String) dipanggil ketika kontrol bukan bagian dari halaman Formulir Web.

-atau-

SetFocus(String) dipanggil setelah PreRender peristiwa.

Contoh

Contoh kode berikut mengatur fokus ke kotak teks kedua pada halaman Web.

Penting

Contoh ini memiliki kotak teks yang menerima input pengguna, yang merupakan potensi ancaman keamanan. Secara default, ASP.NET halaman Web memvalidasi bahwa input pengguna tidak menyertakan elemen skrip atau HTML. Untuk informasi selengkapnya, lihat Gambaran Umum Eksploitasi Skrip.

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

Keterangan

SetFocus Gunakan metode untuk membuat kontrol dengan string ID yang ditentukan sebagai kontrol aktif di halaman Web yang ditampilkan oleh browser. Metode SetFocus harus dipanggil sebelum halaman disiapkan untuk dirender ke klien dalam peristiwa tersebut PreRender .

Catatan

Metode ini SetFocus hanya akan berfungsi pada browser yang mendukung ECMAScript versi 1.3 atau yang lebih baru.

Berlaku untuk