Page.SetFocus Methode

  • Referenz

Definition

Namespace:
System.Web.UI
Assembly:
System.Web.dll

Legt den Browserfokus auf das angegebene Steuerelement fest.

Überlädt

SetFocus(Control)

Legt den Browserfokus auf das angegebene Steuerelement fest.
SetFocus(String)

Legt den Browserfokus auf das Steuerelement mit der angegebenen ID fest.

SetFocus(Control)

Legt den Browserfokus auf das angegebene Steuerelement fest.

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)

Parameter

control
Control

Das Steuerelement, das den Fokus erhalten soll.

Ausnahmen

ArgumentNullException

control ist null.

InvalidOperationException

SetFocus(Control) wird aufgerufen, wenn das Steuerelement kein Bestandteil einer Web Forms-Seite ist.

- oder -

SetFocus(Control) wird nach dem PreRender-Ereignis aufgerufen.

Beispiele

Im folgenden Codebeispiel wird der Fokus auf das zweite Textfeld auf einer Webseite festgelegt.

Wichtig

Dieses Beispiel umfasst ein Textfeld, das Benutzereingaben akzeptiert, die ein potenzielles Sicherheitsrisiko darstellen. Standardmäßig stellen ASP.NET-Webseiten sicher, dass Benutzereingaben keine Skript- oder HTML-Elemente enthalten. Weitere Informationen finden Sie unter Übersicht über Skriptangriffe.

<%@ 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>

Hinweise

Verwenden Sie die SetFocus -Methode, um das angegebene Steuerelement zum aktiven Steuerelement auf der webseite zu machen, die vom Browser angezeigt wird. Die SetFocus -Methode muss aufgerufen werden, bevor die Seite für das Rendern auf dem Client im PreRender Ereignis vorbereitet wird.

Hinweis

Die SetFocus Methode funktioniert nur in Browsern, die ECMAScript Version 1.3 oder höher unterstützen.

Gilt für:

SetFocus(String)

Legt den Browserfokus auf das Steuerelement mit der angegebenen ID fest.

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

Parameter

clientID
String

Die ID des Steuerelements, auf das der Fokus festgelegt werden soll.

Ausnahmen

ArgumentNullException

clientID ist null.

InvalidOperationException

SetFocus(String) wird aufgerufen, wenn das Steuerelement kein Bestandteil einer Web Forms-Seite ist.

- oder -

SetFocus(String) wird nach dem PreRender-Ereignis aufgerufen.

Beispiele

Im folgenden Codebeispiel wird der Fokus auf das zweite Textfeld auf einer Webseite festgelegt.

Wichtig

Dieses Beispiel umfasst ein Textfeld, das Benutzereingaben akzeptiert, die ein potenzielles Sicherheitsrisiko darstellen. Standardmäßig stellen ASP.NET-Webseiten sicher, dass Benutzereingaben keine Skript- oder HTML-Elemente enthalten. Weitere Informationen finden Sie unter Übersicht über Skriptangriffe.

<%@ 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>

Hinweise

Verwenden Sie die SetFocus -Methode, um das Steuerelement mit der angegebenen ID-Zeichenfolge zum aktiven Steuerelement auf der vom Browser angezeigten Webseite zu machen. Die SetFocus -Methode muss aufgerufen werden, bevor die Seite für das Rendern auf dem Client im PreRender Ereignis vorbereitet wird.

Hinweis

Die SetFocus Methode funktioniert nur in Browsern, die ECMAScript Version 1.3 oder höher unterstützen.

Gilt für: