Aracılığıyla paylaş

HtmlForm.DefaultButton Özellik

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 HtmlForm denetimi. 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 kullanıcıların formdaki bir giriş denetiminde (metin kutusu gibi) ENTER tuşuna basarak 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 UniqueIDIButtonControl özelliğini kullanın. Ana sayfalar hakkında daha fazla bilgi için bkz. ASP.NET Ana Sayfalar.

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

  • Odak formdaki giriş denetimlerinin dışındayken ENTER tuşuna basma. 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 basıldığında metin kutusunda yeni bir satır oluşturmasıdır. Bazı tarayıcılarda, çok satırlı metin kutusu içinde ENTER tuşuna basılması geri göndermeyi tetikler. Bu durumda, ENTER işlevinin 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 Partial-Page İşlemeye Genel Bakış.

Şunlara uygulanır

Ayrıca bkz.