Page.SetFocus 메서드

정의

브라우저 포커스를 지정된 컨트롤에 설정합니다.Sets the browser focus to the specified control.

오버로드

SetFocus(Control)

브라우저 포커스를 지정된 컨트롤에 설정합니다.Sets the browser focus to the specified control.

SetFocus(String)

브라우저 포커스를 지정된 식별자를 가진 컨트롤에 설정합니다.Sets the browser focus to the control with the specified identifier.

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
Public Sub SetFocus (control As Control)

매개 변수

control
Control

포커스를 받을 컨트롤입니다.The control to receive focus.

예외

control 에 선언된 기본값은 null입니다.control is null.

컨트롤이 Web Forms 페이지에 속해 있지 않을 때 SetFocus(Control)가 호출된 경우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.

예제

다음 코드 예제에서는 웹 페이지에 두 번째 텍스트 상자에 포커스를 설정 합니다.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 웹 페이지는 사용자 입력 내용에 스크립트 또는 HTML 요소가 포함되어 있지 않은지 확인합니다.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. 자세한 내용은 Script Exploits Overview를 참조하세요.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 메서드를 사용 하 여 브라우저에서 표시 하는 웹 페이지에서 지정 된 컨트롤을 활성 컨트롤로 만듭니다.Use the SetFocus method to make the specified control the active control on the Web page displayed by the browser. PreRender 이벤트에서 클라이언트에 렌더링 하기 위해 페이지를 준비 하기 전에 SetFocus 메서드를 호출 해야 합니다.The 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)

브라우저 포커스를 지정된 식별자를 가진 컨트롤에 설정합니다.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

포커스를 설정할 컨트롤의 ID입니다.The ID of the control to set focus to.

예외

clientID 에 선언된 기본값은 null입니다.clientID is null.

컨트롤이 Web Forms 페이지에 속해 있지 않을 때 SetFocus(String)가 호출된 경우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.

예제

다음 코드 예제에서는 웹 페이지에 두 번째 텍스트 상자에 포커스를 설정 합니다.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 웹 페이지는 사용자 입력 내용에 스크립트 또는 HTML 요소가 포함되어 있지 않은지 확인합니다.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. 자세한 내용은 Script Exploits Overview를 참조하세요.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 문자열을 가진 컨트롤을 활성 컨트롤로 만듭니다.Use the SetFocus method to make the control with the specified ID string the active control in the Web page displayed by the browser. PreRender 이벤트에서 클라이언트에 렌더링 하기 위해 페이지를 준비 하기 전에 SetFocus 메서드를 호출 해야 합니다.The 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.

적용 대상