Page.SetFocus メソッド

  • リファレンス

定義

名前空間:
System.Web.UI
アセンブリ:
System.Web.dll

ブラウザーのフォーカスを、指定したコントロールに設定します。

オーバーロード

SetFocus(Control)

ブラウザーのフォーカスを、指定したコントロールに設定します。
SetFocus(String)

ブラウザーのフォーカスを、指定した ID を持つコントロールに設定します。

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

SetFocus(Control) は、コントロールが Web フォーム ページの一部ではない場合に呼び出されます。

- または -

SetFocus(Control) は、PreRender イベントの後に呼び出されます。

例

次のコード例では、Web ページの 2 番目のテキスト ボックスにフォーカスを設定します。

重要

この例には、ユーザー入力を受け付けるテキスト ボックスがあります。これにより、セキュリティが脆弱になる可能性があります。 既定では、ASP.NET Web ページによって、ユーザー入力にスクリプトまたは HTML 要素が含まれていないかどうかが検証されます。 詳細については、「スクリプトによる攻略の概要」を参照してください。

<%@ 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 表示される Web ページで、指定したコントロールをアクティブなコントロールにするには、 メソッドを使用します。 SetFocusイベントでクライアントにレンダリングするためにページを準備する前に、 メソッドを呼び出すPreRender必要があります。

注意

このメソッドは SetFocus 、ECMAScript バージョン 1.3 以降をサポートするブラウザーでのみ機能します。

適用対象

SetFocus(String)

ブラウザーのフォーカスを、指定した ID を持つコントロールに設定します。

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

SetFocus(String) は、コントロールが Web フォーム ページの一部ではない場合に呼び出されます。

- または -

SetFocus(String) は、PreRender イベントの後に呼び出されます。

例

次のコード例では、Web ページの 2 番目のテキスト ボックスにフォーカスを設定します。

重要

この例には、ユーザー入力を受け付けるテキスト ボックスがあります。これにより、セキュリティが脆弱になる可能性があります。 既定では、ASP.NET Web ページによって、ユーザー入力にスクリプトまたは HTML 要素が含まれていないかどうかが検証されます。 詳細については、「スクリプトによる攻略の概要」を参照してください。

<%@ 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 使用して、指定した ID 文字列を持つコントロールを、ブラウザーによって表示される Web ページのアクティブなコントロールにします。 SetFocusイベントでクライアントにレンダリングするためにページを準備する前に、 メソッドを呼び出すPreRender必要があります。

注意

このメソッドは SetFocus 、ECMAScript バージョン 1.3 以降をサポートするブラウザーでのみ機能します。

適用対象