Page.SetFocus 方法

  • 參考

定義

命名空間:
System.Web.UI
組件:
System.Web.dll

將瀏覽器焦點設為指定的控制項。

多載

SetFocus(Control)

將瀏覽器焦點設為指定的控制項。
SetFocus(String)

將瀏覽器焦點設為具有指定識別項的控制項。

SetFocus(Control)

將瀏覽器焦點設為指定的控制項。

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)

參數

control
Control

接收焦點的控制項。

例外狀況

ArgumentNullException

control 為 null。

InvalidOperationException

當控制項不是 Web Form 網頁的一部分時，便呼叫 SetFocus(Control)。

-或-

在 SetFocus(Control) 事件之後，呼叫 PreRender。

範例

下列程式碼範例會將焦點設定為網頁上的第二個文字方塊。

重要

這個範例有一個可接受使用者輸入的文字方塊，這可能會造成安全性威脅。 根據預設，ASP.NET Web 網頁會驗證使用者輸入未包含指令碼或 HTML 項目。 如需詳細資訊，請參閱 Script Exploits Overview (指令碼攻擊概觀)。

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

備註

SetFocus使用 方法，讓指定的控制項成為瀏覽器所顯示網頁上的使用中控制項。 SetFocus必須先呼叫 方法，才能準備頁面以在 事件中 PreRender 轉譯至用戶端。

注意

方法 SetFocus 僅適用于支援 ECMAScript 1.3 版或更新版本的瀏覽器。

適用於

SetFocus(String)

將瀏覽器焦點設為具有指定識別項的控制項。

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

參數

clientID
String

設定焦點的控制項 ID。

例外狀況

ArgumentNullException

clientID 為 null。

InvalidOperationException

當控制項不是 Web Form 網頁的一部分時，便呼叫 SetFocus(String)。

-或-

在 SetFocus(String) 事件之後，呼叫 PreRender。

範例

下列程式碼範例會將焦點設定為網頁上的第二個文字方塊。

重要

這個範例有一個可接受使用者輸入的文字方塊，這可能會造成安全性威脅。 根據預設，ASP.NET Web 網頁會驗證使用者輸入未包含指令碼或 HTML 項目。 如需詳細資訊，請參閱 Script Exploits Overview (指令碼攻擊概觀)。

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

備註

SetFocus使用 方法，將具有指定識別碼字串的控制項設為瀏覽器所顯示網頁的作用中控制項。 SetFocus必須先呼叫 方法，才能準備頁面以在 事件中 PreRender 轉譯至用戶端。

注意

方法 SetFocus 僅適用于支援 ECMAScript 1.3 版或更新版本的瀏覽器。

適用於