共用方式為

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 僅適用於支援ECMAScript1.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 僅適用於支援ECMAScript1.3版或更新版本的瀏覽器。

適用於