Page.SetFocus Methode

Definitie

Naamruimte:
System.Web.UI
Assembly:
System.Web.dll

Hiermee stelt u de browserfocus in op het opgegeven besturingselement.

Overloads

Name Description
SetFocus(Control)

Hiermee stelt u de browserfocus in op het opgegeven besturingselement.
SetFocus(String)

Hiermee stelt u de focus van de browser in op het besturingselement met de opgegeven id.

SetFocus(Control)

Hiermee stelt u de browserfocus in op het opgegeven besturingselement.

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)

Parameters

control
Control

Het besturingselement dat de focus krijgt.

Uitzonderingen

ArgumentNullException

control is null.

InvalidOperationException

SetFocus(Control) wordt aangeroepen wanneer het besturingselement geen deel uitmaakt van een webpagina met webformulieren.

– of –

SetFocus(Control) wordt aangeroepen na de PreRender gebeurtenis.

Voorbeelden

In het volgende codevoorbeeld wordt de focus ingesteld op het tweede tekstvak op een webpagina.

Important

Dit voorbeeld heeft een tekstvak dat gebruikersinvoer accepteert. Dit is een mogelijke beveiligingsrisico. Standaard valideren ASP.NET webpagina's dat gebruikersinvoer geen script- of HTML-elementen bevat. Zie Overzicht van Script Exploits voor meer informatie.

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

Opmerkingen

Gebruik de SetFocus methode om het opgegeven besturingselement het actieve besturingselement te maken op de webpagina die door de browser wordt weergegeven. De SetFocus methode moet worden aangeroepen voordat de pagina wordt voorbereid op rendering naar de client in de PreRender gebeurtenis.

Note

De SetFocus methode werkt alleen in browsers die ECMAScript versie 1.3 of hoger ondersteunen.

Van toepassing op

SetFocus(String)

Hiermee stelt u de focus van de browser in op het besturingselement met de opgegeven id.

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

Parameters

clientID
String

De id van het besturingselement waar de focus op moet worden ingesteld.

Uitzonderingen

ArgumentNullException

clientID is null.

InvalidOperationException

SetFocus(String) wordt aangeroepen wanneer het besturingselement geen deel uitmaakt van een webpagina met webformulieren.

– of –

SetFocus(String) wordt aangeroepen na de PreRender gebeurtenis.

Voorbeelden

In het volgende codevoorbeeld wordt de focus ingesteld op het tweede tekstvak op een webpagina.

Important

Dit voorbeeld heeft een tekstvak dat gebruikersinvoer accepteert. Dit is een mogelijke beveiligingsrisico. Standaard valideren ASP.NET webpagina's dat gebruikersinvoer geen script- of HTML-elementen bevat. Zie Overzicht van Script Exploits voor meer informatie.

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

Opmerkingen

Gebruik de SetFocus methode om het besturingselement te maken met de opgegeven id-tekenreeks het actieve besturingselement op de webpagina die door de browser wordt weergegeven. De SetFocus methode moet worden aangeroepen voordat de pagina wordt voorbereid op rendering naar de client in de PreRender gebeurtenis.

Note

De SetFocus methode werkt alleen in browsers die ECMAScript versie 1.3 of hoger ondersteunen.

Van toepassing op