Page.SetFocus Page.SetFocus Page.SetFocus Page.SetFocus Method

定義

ブラウザーのフォーカスを指定したコントロールに設定します。Sets the browser focus to the specified control.

オーバーロード

SetFocus(Control) SetFocus(Control) SetFocus(Control)

ブラウザーのフォーカスを指定したコントロールに設定します。Sets the browser focus to the specified control.

SetFocus(String) SetFocus(String) SetFocus(String) SetFocus(String)

ブラウザーのフォーカスを、指定した ID を持つコントロールに設定します。Sets the browser focus to the control with the specified identifier.

SetFocus(Control) SetFocus(Control) SetFocus(Control)

ブラウザーのフォーカスを指定したコントロールに設定します。Sets the browser focus to the specified 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

パラメーター

control
Control Control Control Control

フォーカスが設定されるコントロール。The control to receive focus.

例外

SetFocus(Control) は、コントロールが Web フォーム ページの一部ではない場合に呼び出されます。SetFocus(Control) is called when the control is not part of a Web Forms page.

または-or- SetFocus(Control) は、PreRender イベントの後に呼び出されます。SetFocus(Control) is called after the PreRender event.

次のコード例では、Web ページの2番目のテキストボックスにフォーカスを設定します。The following code example sets the focus to the second text box on a Web page.

重要

この例には、ユーザー入力を受け付けるテキスト ボックスがあります。これにより、セキュリティが脆弱になる可能性があります。This example has a text box that accepts user input, which is a potential security threat. 既定では、ASP.NET Web ページによって、ユーザー入力にスクリプトまたは HTML 要素が含まれていないかどうかが検証されます。By default, ASP.NET Web pages validate that user input does not include script or HTML elements. 詳細については、「スクリプトによる攻略の概要」を参照してください。For more information, see 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メソッドを使用して、ブラウザーによって表示される Web ページで、指定したコントロールをアクティブなコントロールにします。Use the SetFocus method to make the specified control the active control on the Web page displayed by the browser. イベントでクライアントに表示するためにページを準備する前に、メソッドをSetFocus呼び出す必要があります。 PreRenderThe SetFocus method must be called before the page is prepared for rendering to the client in the PreRender event.

注意

メソッドSetFocusは、ECMAScript バージョン1.3 以降をサポートするブラウザーでのみ動作します。The SetFocus method will work only on browsers supporting ECMAScript version 1.3 or later.

SetFocus(String) SetFocus(String) SetFocus(String) SetFocus(String)

ブラウザーのフォーカスを、指定した ID を持つコントロールに設定します。Sets the browser focus to the control with the specified identifier.

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

パラメーター

clientID
String String String String

フォーカスを設定するコントロールの ID。The ID of the control to set focus to.

例外

SetFocus(String) は、コントロールが Web フォーム ページの一部ではない場合に呼び出されます。SetFocus(String) is called when the control is not part of a Web Forms page.

- または --or- SetFocus(String) は、PreRender イベントの後に呼び出されます。SetFocus(String) is called after the PreRender event.

次のコード例では、Web ページの2番目のテキストボックスにフォーカスを設定します。The following code example sets the focus to the second text box on a Web page.

重要

この例には、ユーザー入力を受け付けるテキスト ボックスがあります。これにより、セキュリティが脆弱になる可能性があります。This example has a text box that accepts user input, which is a potential security threat. 既定では、ASP.NET Web ページによって、ユーザー入力にスクリプトまたは HTML 要素が含まれていないかどうかが検証されます。By default, ASP.NET Web pages validate that user input does not include script or HTML elements. 詳細については、「スクリプトによる攻略の概要」を参照してください。For more information, see 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メソッドを使用して、指定した ID 文字列を持つコントロールを、ブラウザーによって表示される Web ページ内のアクティブなコントロールにします。Use the SetFocus method to make the control with the specified ID string the active control in the Web page displayed by the browser. イベントでクライアントに表示するためにページを準備する前に、メソッドをSetFocus呼び出す必要があります。 PreRenderThe SetFocus method must be called before the page is prepared for rendering to the client in the PreRender event.

注意

メソッドSetFocusは、ECMAScript バージョン1.3 以降をサポートするブラウザーでのみ動作します。The SetFocus method will work only on browsers supporting ECMAScript version 1.3 or later.

適用対象