HtmlForm.DefaultFocus Eigenschaft

  • Referenz

Definition

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

Ruft das Steuerelement im Formular ab, das als Steuerelement mit dem Eingabefokus angezeigt wird, wenn das HtmlForm-Steuerelement geladen wird, oder legt dieses fest.

public:
 property System::String ^ DefaultFocus { System::String ^ get(); void set(System::String ^ value); };
public string DefaultFocus { get; set; }
member this.DefaultFocus : string with get, set
Public Property DefaultFocus As String

Eigenschaftswert

String

Die ClientID des Steuerelements im Formular, das als Steuerelement mit dem Eingabefokus angezeigt wird, wenn das HtmlForm-Steuerelement geladen wird. Der Standardwert ist eine leere Zeichenfolge ("").

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Die DefaultFocus Eigenschaft so festgelegt wird, dass ein angegebenes Steuerelement in einem Formular als Steuerelement mit Eingabefokus angezeigt wird, wenn das Formular geladen wird. Form1 Beachten Sie beim Rendern, dass sich die Einfügemarke befindetTextBox1, die angibt, dass TextBox1 es sich um das Steuerelement mit Fokus handelt.

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

Hinweise

Verwenden Sie die DefaultFocus Eigenschaft, um auf das Steuerelement im Formular zuzugreifen, um als Steuerelement mit Eingabefokus anzuzeigen, wenn das HtmlForm Steuerelement geladen wird. Steuerelemente, die ausgewählt werden können, werden mit einem visuellen Hinweis angezeigt, der angibt, dass sie den Fokus haben. Ein Steuerelement mit Fokus wird beispielsweise mit der Einfügemarke angezeigt, TextBox die innerhalb dieses Steuerelements positioniert ist.

Das Steuerelement mit Fokus kann auch mithilfe der Focus Methoden oder SetFocus Methoden festgelegt werden. Diese Methoden haben Vorrang vor der DefaultFocus Eigenschaft. Wenn eine dieser Methoden aufgerufen wird, um das Steuerelement mit Fokus festzulegen, wird der Wert der DefaultFocus Eigenschaft ignoriert.

Gilt für

Siehe auch