Udostępnij za pośrednictwem

HtmlForm.DefaultButton Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI.HtmlControls
Zestaw:
System.Web.dll

Pobiera lub ustawia podrzędną kontrolkę HtmlForm , która powoduje ogłaszanie zwrotne po naciśnięciu klawisza 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

Wartość właściwości

String

Kontrolka ID przycisku, która ma być wyświetlana jako przycisk domyślny podczas HtmlForm ładowania. Wartością domyślną jest ciąg pusty ("").

Wyjątki

InvalidOperationException

Kontrolka, do których odwołuje się przycisk domyślny, nie ma typu IButtonControl.

Przykłady

W poniższym przykładzie pokazano, jak ustawić właściwość w celu ustawienia DefaultButton domyślnej kontrolki, która powoduje ogłaszanie zwrotne.

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

Uwagi

Właściwość DefaultButton umożliwia określenie, że użytkownicy mogą powodować ogłaszanie zwrotne, naciskając klawisz ENTER w kontrolce wprowadzania w formularzu (na przykład pole tekstowe). Jako przycisk domyślny można określić dowolną kontrolkę pochodzącą z interfejsu z IButtonControl wyjątkiem kontrolki LinkButton . Jeśli kontrolka, DefaultButton do którego odwołuje się właściwość , nie pochodzi z IButtonControlklasy , InvalidOperationException zgłaszany jest wyjątek.

Jeśli używasz stron wzorcowych i ustawisz DefaultButton właściwość na stronie zawartości, użyj UniqueID właściwości IButtonControl przycisku. Aby uzyskać więcej informacji na temat stron wzorcowych, zobacz ASP.NET stron wzorcowych.

Właściwość DefaultButton może nie powodować ogłaszania zwrotnego w następujących scenariuszach:

  • Naciśnięcie klawisza ENTER, gdy fokus znajduje się poza kontrolkami wejściowymi w formularzu. Nie ma gwarancji, że zostanie wyzwolona domyślna akcja ogłaszania zwrotnego.

  • Naciśnięcie klawisza ENTER, gdy fokus znajduje się wewnątrz wielowierszowego pola tekstowego. W wielowierszowym polu tekstowym oczekiwane zachowanie polega na tym, że naciśnięcie klawisza ENTER powoduje utworzenie nowego wiersza w polu tekstowym. W niektórych przeglądarkach naciśnięcie klawisza ENTER wewnątrz wielowierszowego pola tekstowego wyzwala ogłaszanie zwrotne. W takim przypadku, jeśli chcesz zamiast tego utworzyć nowy wiersz, możesz dołączyć funkcję JavaScript do kontrolki wejściowej. Skrypt powinien przechwycić klucz ENTER i zatrzymać ogłaszanie zwrotne. Na przykład możesz użyć Attributes kolekcji właściwości, aby dodać skrypt klienta dla onKeyPress zdarzenia.

  • Określanie kontrolki LinkButton jako przycisku domyślnego. Obsługiwane są tylko Button kontrolki i ImageButton .

  • DefaultButton Programowe zmienianie właściwości podczas asynchronicznego ogłaszania zwrotnego. Asynchroniczne ogłaszanie zwrotne można włączyć na stronie, dodając do strony co najmniej jedną UpdatePanel kontrolkę. Aby uzyskać więcej informacji, zobacz UpdatePanel Control Overview (Omówienie kontrolki UpdatePanel) i Partial-Page Rendering Overview (Omówienie renderowania częściowego strony).

Dotyczy

Zobacz też