Aracılığıyla paylaş

HtmlForm.DefaultButton Özellik

  • Başvuru

Tanım

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

ENTER tuşuna basıldığında geri göndermeye HtmlForm neden olan denetimin alt denetimini alır veya ayarlar.

public:
 property System::String ^ DefaultButton { System::String ^ get(); void set(System::String ^ value); };
public string DefaultButton { get; set; }
member this.DefaultButton : string with get, set
Public Property DefaultButton As String

Özellik Değeri

String

ID yüklendiğinde varsayılan düğme olarak görüntülenecek düğme denetiminin HtmlForm değeri. Varsayılan değer boş bir dizedir ("").

Özel durumlar

InvalidOperationException

Varsayılan düğme olarak başvurulan denetim türünde IButtonControldeğildir.

Örnekler

Aşağıdaki örnekte, geri göndermeye DefaultButton neden olan varsayılan denetimi ayarlamak için özelliğinin nasıl ayarlanacağı gösterilmektedir.

<%@ 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_Load(object sender, System.EventArgs e)
  {
    
    // Set the text of the two label controls.
    Label1.Text = "The DefaultButton property is set to "
                + Form1.DefaultButton.ToString() + "<br/>";
    Label2.Text = "The DefaultFocus property is set to "
                + Form1.DefaultFocus.ToString();
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >

<head>

    <title>HtmlForm DefaultButton and DefaultFocus Properties Example</title>

</head>

<body>

  <form id="Form1"
        defaultbutton="SubmitButton"
        defaultfocus="TextBox1"
        runat="server">
    
    <h3>HtmlForm DefaultButton and DefaultFocus Properties Example</h3>        
  
    TextBox1:
    <asp:textbox id="TextBox1"
                 autopostback="true" 
                 runat="server">
    </asp:textbox>
  
    <br />
  
    TextBox2:
    <asp:textbox id="TextBox2"
                 autopostback="true" 
                 runat="server">
    </asp:textbox>
  
    <br /><br />
  
    <asp:button id="SubmitButton"
                text="Submit" 
                runat="server">
    </asp:button>
  
    <asp:button id="CancelButton" 
                text="Cancel"
                runat="server">
    </asp:button>
  
    <hr />
  
    <asp:label id="Label1"
               runat="Server">
    </asp:label>
  
    <asp:label id="Label2"
               runat="Server">
    </asp:label>

  </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_Load(ByVal sender As Object, ByVal e As System.EventArgs)
    
    ' Set the text of the two label controls.
    Label1.Text = "The DefaultButton property is set to " _
                  & Form1.DefaultButton.ToString & "<br/>"
    Label2.Text = "The DefaultFocus property is set to " _
                  & Form1.DefaultFocus.ToString
  End Sub
     
 </script>

<html xmlns="http://www.w3.org/1999/xhtml" >

<head>

    <title>HtmlForm DefaultButton and DefaultFocus Properties Example</title>

</head>

<body>

  <form id="Form1"
        defaultbutton="SubmitButton"
        defaultfocus="TextBox1"
        runat="server">
    
    <h3>HtmlForm DefaultButton and DefaultFocus Properties Example</h3>        
  
    TextBox1:
    <asp:textbox id="TextBox1"
                 autopostback="true" 
                 runat="server">
    </asp:textbox>
  
    <br />
  
    TextBox2:
    <asp:textbox id="TextBox2"
                 autopostback="true" 
                 runat="server">
    </asp:textbox>
  
    <br /><br />
  
    <asp:button id="SubmitButton"
                text="Submit" 
                runat="server">
    </asp:button>
  
    <asp:button id="CancelButton" 
                text="Cancel"
                runat="server">
    </asp:button>
  
    <hr />
  
    <asp:label id="Label1"
               runat="Server">
    </asp:label>
  
    <asp:label id="Label2"
               runat="Server">
    </asp:label>

  </form>

</body>

</html>

Açıklamalar

özelliği, DefaultButton formdaki bir giriş denetiminde (metin kutusu gibi) ENTER tuşuna basarak kullanıcıların geri göndermeye neden olabileceğini belirtmenize olanak tanır. Denetim dışında LinkButton arabirimden IButtonControl türetilen herhangi bir denetimi varsayılan düğme olarak belirtebilirsiniz. özelliği tarafından DefaultButton başvurulan denetim' den IButtonControltüretilmezse bir InvalidOperationException özel durum oluşturulur.

Ana sayfalar kullanıyorsanız ve özelliği bir içerik sayfasından DefaultButton ayarladıysanız düğmenin IButtonControl özelliğini kullanınUniqueID. Ana sayfalar hakkında daha fazla bilgi için bkz. ana sayfalar ASP.NET.

DefaultButton özelliği aşağıdaki senaryolarda geri göndermeye neden olmayabilir:

  • Odak formdaki giriş denetimlerinin dışındayken ENTER tuşuna basın. Varsayılan geri gönderme eyleminin tetiklenme garantisi yok.

  • Odak çok satırlı bir metin kutusunun içindeyken ENTER tuşuna basma. Çok satırlı bir metin kutusunda beklenen davranış, ENTER tuşuna basmanın metin kutusunda yeni bir satır oluşturmasıdır. Bazı tarayıcılarda, çok satırlı bir metin kutusunun içinde ENTER tuşuna basılması geri göndermeyi tetikler. Bu durumda, ENTER'ın bunun yerine yeni bir satır oluşturmasını istiyorsanız, giriş denetimine bir JavaScript işlevi ekleyebilirsiniz. Betik ENTER anahtarını yakalamalı ve geri göndermeyi durdurmalıdır. Örneğin, olay için istemci betiği eklemek için onKeyPress özellik koleksiyonunu kullanabilirsinizAttributes.

  • LinkButton Denetimi varsayılan düğme olarak belirtme. Yalnızca Button ve ImageButton denetimleri desteklenir.

  • DefaultButton Zaman uyumsuz geri gönderme sırasında özelliği program aracılığıyla değiştirme. Zaman uyumsuz geri göndermeler, sayfaya bir veya daha fazla UpdatePanel denetim eklenerek sayfada etkinleştirilebilir. Daha fazla bilgi için bkz . UpdatePanel Denetimine Genel Bakış ve Kısmi Sayfa İşlemeye Genel Bakış.

Şunlara uygulanır

Ayrıca bkz.