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

Метод SetFocus(Control) вызывается, когда элемент управления не является частью страницы веб-формы.

-или-

Метод SetFocus(Control) вызывается после события PreRender.

Примеры

В следующем примере кода фокус устанавливается на второе текстовое поле на веб-странице.

Важно!

В этом примере имеется текстовое поле, принимающее вводимые пользователем данные, что является потенциальной угрозой безопасности. По умолчанию данные, вводимые пользователем на веб-страницах ASP.NET, проверяются на наличие скриптов и 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 чтобы сделать указанный элемент управления активным на веб-странице, отображаемой браузером. Метод SetFocus должен быть вызван до подготовки страницы для отрисовки для клиента в событии PreRender .

Примечание

Метод SetFocus будет работать только в браузерах, поддерживающих ECMAScript версии 1.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

Идентификатор элемента управления, получающего фокус.

Исключения

ArgumentNullException

clientID имеет значение null.

InvalidOperationException

Метод SetFocus(String) вызывается, когда элемент управления не является частью страницы веб-формы.

-или-

Метод SetFocus(String) вызывается после события PreRender.

Примеры

В следующем примере кода фокус устанавливается на второе текстовое поле на веб-странице.

Важно!

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

Примечание

Метод SetFocus будет работать только в браузерах, поддерживающих ECMAScript версии 1.3 или более поздней.

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