Page.SetFocus Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.Web.UI
Bütünleştirilmiş Kod:
System.Web.dll

Tarayıcı odağını belirtilen denetime ayarlar.

Aşırı Yüklemeler

SetFocus(Control)

Tarayıcı odağını belirtilen denetime ayarlar.
SetFocus(String)

Tarayıcı odağını belirtilen tanımlayıcıyla denetime ayarlar.

SetFocus(Control)

Tarayıcı odağını belirtilen denetime ayarlar.

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)

Parametreler

control
Control

Odağı alacak denetim.

Özel durumlar

ArgumentNullException

control, null değeridir.

InvalidOperationException

SetFocus(Control) , denetim bir Web Forms sayfasının parçası olmadığında çağrılır.

-veya-

SetFocus(Control) , olaydan sonra çağrılır PreRender .

Örnekler

Aşağıdaki kod örneği, odağı Web sayfasındaki ikinci metin kutusuna ayarlar.

Önemli

Bu örnekte, olası bir güvenlik tehdidi olan kullanıcı girişini kabul eden bir metin kutusu vardır. Varsayılan olarak, ASP.NET Web sayfaları kullanıcı girişinin betik veya HTML öğeleri içermediğini doğrular. Daha fazla bilgi için bkz . Betik Açıklarına Genel Bakış.

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

Açıklamalar

SetFocus Belirtilen denetimi tarayıcı tarafından görüntülenen Web sayfasında etkin denetim yapmak için yöntemini kullanın. Olayda SetFocus istemciye PreRender işleme için sayfa hazırlanmadan önce yöntemi çağrılmalıdır.

Not

SetFocus yöntemi yalnızca ECMAScript sürüm 1.3 veya üzerini destekleyen tarayıcılarda çalışır.

Şunlara uygulanır

SetFocus(String)

Tarayıcı odağını belirtilen tanımlayıcıyla denetime ayarlar.

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

Parametreler

clientID
String

Odağın ayarlanacağı denetimin kimliği.

Özel durumlar

ArgumentNullException

clientID, null değeridir.

InvalidOperationException

SetFocus(String) , denetim bir Web Forms sayfasının parçası olmadığında çağrılır.

-veya-

SetFocus(String) , olaydan sonra çağrılır PreRender .

Örnekler

Aşağıdaki kod örneği, odağı Web sayfasındaki ikinci metin kutusuna ayarlar.

Önemli

Bu örnekte, olası bir güvenlik tehdidi olan kullanıcı girişini kabul eden bir metin kutusu vardır. Varsayılan olarak, ASP.NET Web sayfaları kullanıcı girişinin betik veya HTML öğeleri içermediğini doğrular. Daha fazla bilgi için bkz . Betik Açıklarına Genel Bakış.

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

Açıklamalar

SetFocus Belirtilen kimlik dizesine sahip denetimi, tarayıcı tarafından görüntülenen Web sayfasında etkin denetim yapmak için yöntemini kullanın. Olayda SetFocus istemciye PreRender işleme için sayfa hazırlanmadan önce yöntemi çağrılmalıdır.

Not

SetFocus yöntemi yalnızca ECMAScript sürüm 1.3 veya üzerini destekleyen tarayıcılarda çalışır.

Şunlara uygulanır