HtmlForm.DefaultButton Eigenschap

Definitie

Naamruimte:
System.Web.UI.HtmlControls
Assembly:
System.Web.dll

Hiermee haalt u het onderliggende besturingselement op van het HtmlForm besturingselement dat een terugdraaibewerking veroorzaakt wanneer de ENTER-toets wordt ingedrukt.

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

Waarde van eigenschap

String

Het ID besturingselement voor de knop die moet worden weergegeven als de standaardknop wanneer de HtmlForm knop wordt geladen. De standaardwaarde is een lege tekenreeks ("").

Uitzonderingen

InvalidOperationException

Het besturingselement waarnaar wordt verwezen als de standaardknop is niet van het type IButtonControl.

Voorbeelden

In het volgende voorbeeld ziet u hoe u de DefaultButton eigenschap instelt om het standaardbesturingselement in te stellen dat een terugpost veroorzaakt.

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

Opmerkingen

Met DefaultButton de eigenschap kunt u opgeven dat gebruikers een terugpost kunnen veroorzaken door op Enter te drukken in een invoerbesturingselement in het formulier (zoals een tekstvak). U kunt opgeven als een standaardknop elk besturingselement dat is afgeleid van de IButtonControl interface, behalve het LinkButton besturingselement. Als het besturingselement waarnaar wordt verwezen door de DefaultButton eigenschap niet is afgeleid IButtonControl, wordt er een InvalidOperationException uitzondering gegenereerd.

Als u basispagina's gebruikt en de DefaultButton eigenschap instelt vanaf een inhoudspagina, gebruikt u de UniqueID eigenschap van de IButtonControl knop. Zie ASP.NET basispagina's voor meer informatie over basispagina's.

De DefaultButton eigenschap veroorzaakt mogelijk geen terugpost in de volgende scenario's:

  • Druk op ENTER wanneer de focus zich buiten de invoerbesturingselementen in het formulier bevindt. De standaardactie voor terugdraaien is niet gegarandeerd geactiveerd.

  • Druk op ENTER wanneer de focus zich in een tekstvak met meerdere regels bevindt. In een tekstvak met meerdere regels wordt een nieuwe regel in het tekstvak gemaakt door op Enter te drukken. In sommige browsers wordt een postback geactiveerd door op Enter in een tekstvak met meerdere regels te drukken. Als u in dat geval een nieuwe regel wilt maken, kunt u een JavaScript-functie koppelen aan het invoerbeheer. Het script moet de ENTER-sleutel vastleggen en de postback stoppen. U kunt bijvoorbeeld de Attributes eigenschapverzameling gebruiken om het clientscript voor de onKeyPress gebeurtenis toe te voegen.

  • LinkButton Een besturingselement opgeven als een standaardknop. Alleen Button en ImageButton besturingselementen worden ondersteund.

  • DefaultButton De eigenschap programmatisch wijzigen tijdens een asynchrone postback. Asynchrone postbacks kunnen op een pagina worden ingeschakeld door een of meer UpdatePanel besturingselementen toe te voegen aan de pagina. Zie Overzicht van UpdatePanel-besturingselementen en Partial-Page Rendering voor meer informatie.

Van toepassing op

Zie ook