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

Параметры

control
Control

Элемент управления, получающий фокус ввода.The control to receive focus.

Исключения

Свойство control имеет значение null.control is null.

Метод 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. Дополнительные сведения см. в разделе Общие сведения об использовании сценариев.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. Метод SetFocus должен быть вызван до подготовки страницы к отрисовке клиенту в событии PreRender.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

Идентификатор элемента управления, получающего фокус.The ID of the control to set focus to.

Исключения

Свойство clientID имеет значение null.clientID is null.

Метод 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. Дополнительные сведения см. в разделе Общие сведения об использовании сценариев.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, чтобы сделать элемент управления с указанной строкой идентификатора активным элементом управления в веб-странице, отображаемой браузером.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 должен быть вызван до подготовки страницы к отрисовке клиенту в событии PreRender.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.

Применяется к