Freigeben über

HtmlForm.DefaultFocus Eigenschaft

Definition

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

Ruft das Steuerelement im Formular ab, das beim Laden des Steuerelements als Steuerelement mit Eingabefokus angezeigt wird, oder legt es HtmlForm 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

Das ClientID Steuerelement im Formular, das beim Laden als Steuerelement mit Eingabefokus HtmlForm angezeigt werden soll. Der Standardwert ist eine leere Zeichenfolge ("").

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die DefaultFocus Eigenschaft so festgelegt wird, dass ein angegebenes Steuerelement auf einem Formular als Steuerelement mit Eingabefokus angezeigt wird, wenn das Formular geladen wird. Beachten Form1 Sie beim Rendern, dass die Einfügemarke positioniert TextBox1ist, 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 beim Laden des HtmlForm Steuerelements als Steuerelement mit Eingabefokus anzuzeigen. Steuerelemente, die ausgewählt werden können, werden mit einem visuellen Hinweis angezeigt, der angibt, dass sie den Fokus haben. Beispielsweise wird ein TextBox Steuerelement mit Fokus mit der Einfügemarke angezeigt, die darin positioniert ist.

Das Steuerelement mit Fokus kann auch mit den 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:

Weitere Informationen