HtmlForm.DefaultButton Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI.HtmlControls
Assembly:
System.Web.dll

Ottiene o imposta il controllo figlio del controllo HtmlForm che determina il postback quando viene premuto INVIO.

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

Valore della proprietà

String

Controllo ID del controllo pulsante da visualizzare come pulsante predefinito quando viene caricato il controllo HtmlForm. Il valore predefinito è una stringa vuota ("").

Eccezioni

InvalidOperationException

Il tipo del controllo indicato come pulsante predefinito non è IButtonControl.

Esempio

Nell'esempio seguente viene illustrato come impostare la proprietà per impostare il DefaultButton controllo predefinito che causa un 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>

Commenti

La DefaultButton proprietà consente di specificare che gli utenti possono causare un postback premendo INVIO in un controllo di input nel modulo , ad esempio una casella di testo. È possibile specificare come pulsante predefinito qualsiasi controllo che deriva dall'interfaccia, ad eccezione del IButtonControlLinkButton controllo. Se il controllo a cui fa riferimento la DefaultButton proprietà non deriva da IButtonControl, viene generata un'eccezione InvalidOperationException .

Se si usano pagine master e si imposta la proprietà da una pagina del contenuto, usare la DefaultButtonUniqueID proprietà del IButtonControl pulsante. Per altre informazioni sulle pagine master, vedere ASP.NET Pagine master.

La DefaultButton proprietà potrebbe non causare un postback negli scenari seguenti:

  • Premere INVIO quando lo stato attivo si trova all'esterno dei controlli di input nel modulo. L'azione di postback predefinita non è garantita per essere attivata.

  • Premendo INVIO quando lo stato attivo si trova all'interno di una casella di testo a più righe. In una casella di testo a più righe, il comportamento previsto è che premendo INVIO crea una nuova riga nella casella di testo. In alcuni browser premere INVIO all'interno di una casella di testo a più righe attiva un postback. In tal caso, se si vuole creare una nuova riga, è possibile collegare una funzione JavaScript al controllo di input. Lo script deve acquisire la chiave ENTER e arrestare il postback. Ad esempio, è possibile usare la Attributes raccolta di proprietà per aggiungere script client per l'evento onKeyPress .

  • Specifica di un LinkButton controllo come pulsante predefinito. Sono supportati solo Button i controlli e ImageButton .

  • Modifica della DefaultButton proprietà a livello di codice durante un postback asincrono. I postback asincroni possono essere abilitati in una pagina aggiungendo uno o più UpdatePanel controlli alla pagina. Per altre informazioni, vedere Panoramica del controllo UpdatePanel e Panoramica del rendering di pagine parziali.

Si applica a

Vedi anche