HtmlForm.DefaultButton Egenskap

Definition

Namnområde:
System.Web.UI.HtmlControls
Sammansättning:
System.Web.dll

Hämtar eller anger den underordnade kontrollen för den HtmlForm kontroll som orsakar postback när RETUR-tangenten trycks in.

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

Egenskapsvärde

String

Knappkontrollen ID som ska visas som standardknapp när den HtmlForm läses in. Standardvärdet är en tom sträng ("").

Undantag

InvalidOperationException

Kontrollen som refereras till som standardknappen är inte av typen IButtonControl.

Exempel

I följande exempel visas hur du ställer in DefaultButton egenskapen för att ange den standardkontroll som orsakar en postback.

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

Kommentarer

Med DefaultButton egenskapen kan du ange att användare kan orsaka ett återanrop genom att trycka på RETUR i en indatakontroll i formuläret (till exempel en textruta). Som standardknapp kan du ange alla kontroller som härleds från IButtonControl gränssnittet förutom LinkButton kontrollen. Om kontrollen som refereras av DefaultButton egenskapen inte härleds från IButtonControlgenereras ett InvalidOperationException undantag.

Om du använder huvudsidor och anger DefaultButton egenskapen från en innehållssida använder UniqueID du knappens IButtonControl egenskap. Mer information om huvudsidor finns i ASP.NET huvudsidor.

Egenskapen DefaultButton kanske inte orsakar ett återanrop i följande scenarier:

  • Tryck på RETUR när fokus ligger utanför indatakontrollerna i formuläret. Standardåtgärden efteråterställning är inte garanterad att utlösas.

  • Tryck på RETUR när fokus ligger i en textruta med flera rader. I en textruta med flera rader är det förväntade beteendet att om du trycker på RETUR skapas en ny rad i textrutan. Om du trycker på RETUR i en textruta med flera rader i vissa webbläsare utlöses ett återanrop. Om du i så fall vill att RETUR ska skapa en ny rad i stället kan du koppla en JavaScript-funktion till indatakontrollen. Skriptet ska samla in RETUR-nyckeln och stoppa efteråterställningen. Du kan till exempel använda egenskapssamlingen Attributes för att lägga till klientskript för onKeyPress händelsen.

  • Ange en LinkButton kontroll som en standardknapp. Endast Button kontroller och ImageButton stöds.

  • Ändra egenskapen DefaultButton programmatiskt under en asynkron postback. Asynkrona postbacks kan aktiveras på en sida genom att lägga till en eller flera UpdatePanel kontroller på sidan. Mer information finns i Översikt över UpdatePanel-kontroll och Partial-Page renderingsöversikt.

Gäller för

Se även