Share via

HtmlForm.DefaultButton Vlastnost

  • Reference

Definice

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

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 is načten.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 pro nastavení výchozího ovládacího prvku, který způsobí 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é můžou způsobit zpětné odeslání stisknutím klávesy ENTER v ovládacím prvku vstupu 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í s výjimkou 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 postback v následujících scénářích:

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

  • 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 enter místo toho 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 postbacku. 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

Viz také