HtmlForm.DefaultButton Vlastnost

Reference

Definice

Obor názvů:: System.Web.UI.HtmlControls

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Získá nebo nastaví podřízený ovládací prvek HtmlForm ovládacího prvku, 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

The ID of the button control to display as the default button when HtmlForm is loaded. Výchozí hodnota je prázdný řetězec ("").

Výjimky

InvalidOperationException

Ovládací prvek, na který se odkazuje jako na 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 v textovém poli). Jako výchozí tlačítko můžete zadat jakýkoli ovládací prvek, který je odvozen z IButtonControl rozhraní kromě LinkButton ovládacího prvku . Pokud ovládací prvek, na který odkazuje DefaultButton vlastnost, 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 zpětné odeslání v následujících scénářích:

Stisknutí klávesy ENTER, když je fokus mimo vstupní ovládací prvky ve formuláři. Není zaručeno, že se aktivuje výchozí akce zpětného odeslání.
Stisknutí klávesy ENTER, když je fokus uvnitř víceřádkového textového pole. U víceřádkového textového pole se očekává, že stisknutím klávesy ENTER se v textovém poli vytvoří nový řádek. V některých prohlížečích se stisknutím klávesy ENTER uvnitř víceřádkového textového pole aktivuje zpětné odeslání. V takovém případě, pokud chcete, aby místo toho enter vytvořil nový řádek, můžete k ovládacímu prvku vstupu připojit funkci JavaScriptu. Skript by měl zachytit klávesu ENTER a zastavit postback. Kolekci vlastností můžete například použít k přidání klientského AttributesonKeyPress skriptu pro událost.
Určení LinkButton ovládacího prvku jako výchozího tlačítka Podporují se jenom Button ovládací prvky a ImageButton .
DefaultButton Změna vlastnosti programově během asynchronního postback. Asynchronní postback je možné na stránce povolit přidáním jednoho nebo více UpdatePanel ovládacích prvků na stránku. Další informace najdete v tématu Přehled ovládacího prvku UpdatePanel a Přehled vykreslování částečné stránky.

Platí pro

Sdílet prostřednictvím