Page.SetFocus Methode

Definition

Namespace:: System.Web.UI

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Legt den Browserfokus auf das angegebene Steuerelement fest.

Überlädt

Name	Beschreibung
SetFocus(Control)	Legt den Browserfokus auf das angegebene Steuerelement fest.
SetFocus(String)	Legt den Browserfokus auf das Steuerelement mit dem angegebenen Bezeichner 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 erhält.

Ausnahmen

ArgumentNullException

control ist null.

InvalidOperationException

SetFocus(Control) wird aufgerufen, wenn das Steuerelement nicht Teil 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.

Important

In diesem Beispiel handelt es sich um ein Textfeld, das Benutzereingaben akzeptiert, bei denen es sich um eine potenzielle Sicherheitsrisiken handelt. Standardmäßig überprüfen ASP.NET Webseiten, dass die Benutzereingabe keine Skript- oder HTML-Elemente enthält. Weitere Informationen finden Sie unter 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>

Hinweise

Verwenden Sie die SetFocus Methode, um das angegebene Steuerelement als aktives Steuerelement auf der Webseite anzuzeigen, die vom Browser angezeigt wird. Die SetFocus Methode muss aufgerufen werden, bevor die Seite für das Rendern auf den Client im PreRender Ereignis vorbereitet wird.

Note

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

Gilt für:

SetFocus(String)

Legt den Browserfokus auf das Steuerelement mit dem angegebenen Bezeichner 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 nicht Teil 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.

Important

<%@ 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 Webseite zu machen, die vom Browser angezeigt wird. Die SetFocus Methode muss aufgerufen werden, bevor die Seite für das Rendern auf den Client im PreRender Ereignis vorbereitet wird.

Note

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

Gilt für:

Feedback

War diese Seite hilfreich?