Sdílet prostřednictvím

HtmlForm.DefaultButton Vlastnost

Definice

Obor názvů:
System.Web.UI.HtmlControls
Sestavení:
System.Web.dll

Získá nebo nastaví podřízený ovládací prvek ovládacího prvku HtmlForm , který způsobuje postback při stisknutí klávesy ENTER.

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

Hodnota vlastnosti

String

Ovládací ID prvek tlačítka, který se má při načtení zobrazit jako výchozí tlačítko HtmlForm . Výchozí hodnota je prázdný řetězec ("").

Výjimky

InvalidOperationException

Ovládací prvek odkazovaný jako výchozí tlačítko není typu IButtonControl.

Příklady

Následující příklad ukazuje, jak nastavit DefaultButton vlastnost nastavit výchozí ovládací prvek, který způsobuje 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>

Poznámky

Vlastnost DefaultButton umožňuje určit, že uživatelé mohou způsobit zpětné odeslání stisknutím klávesy ENTER ve vstupním ovládacím prvku ve formuláři (například textové pole). Jako výchozí tlačítko můžete zadat libovolný ovládací prvek odvozený z IButtonControl rozhraní s výjimkou LinkButton ovládacího prvku. Pokud ovládací prvek odkazovaný vlastností DefaultButton není odvozen z IButtonControl, InvalidOperationException je vyvolán výjimka.

Pokud používáte stránky předlohy a nastavíte DefaultButton vlastnost ze stránky obsahu, použijte UniqueID vlastnost IButtonControl tlačítka. Další informace o stránkách předlohy najdete v tématu ASP.NET stránky předlohy.

Vlastnost DefaultButton nemusí způsobit postback v následujících scénářích:

  • Stisknutí klávesy ENTER, pokud je fokus mimo vstupní ovládací prvky ve formuláři. Výchozí akce zpětného odeslání není zaručena, že se aktivuje.

  • Když je fokus uvnitř víceřádkového textového pole, stiskněte ENTER. V textovém poli s více řádky očekávané chování spočívá v tom, že stisknutím klávesy ENTER se v textovém poli vytvoří nový řádek. V některých prohlížečích aktivuje stisknutí klávesy ENTER uvnitř víceřádkového textového pole zpětné odeslání. Pokud chcete, aby příkaz ENTER místo toho vytvořil nový řádek, můžete k vstupnímu ovládacímu prvku připojit funkci JavaScriptu. Skript by měl zachytit klíč ENTER a zastavit postback. Kolekci vlastností můžete například použít k přidání klientského AttributesonKeyPress skriptu pro událost.

  • Zadání LinkButton ovládacího prvku jako výchozího tlačítka Podporují se jenom Button ovládací prvky a ImageButton ovládací prvky.

  • DefaultButton Změna vlastnosti programově během asynchronního postbacku. Asynchronní postbacky lze na stránce povolit přidáním jednoho nebo více UpdatePanel ovládacích prvků na stránku. Další informace naleznete v tématu Přehled ovládacího prvku UpdatePanel a přehledPartial-Page Vykreslování.

Platí pro

Viz také