WebControl.TabIndex Eigenschaft

Definition

Ruft den Index der Aktivierreihenfolge des Webserversteuerelements ab oder legt diesen fest.Gets or sets the tab index of the Web server control.

public:
 virtual property short TabIndex { short get(); void set(short value); };
public virtual short TabIndex { get; set; }
member this.TabIndex : int16 with get, set
Public Overridable Property TabIndex As Short

Eigenschaftswert

Der Index der Aktivierreihenfolge des Webserversteuerelements.The tab index of the Web server control. Der Standardwert ist 0 und gibt an, dass diese Eigenschaft nicht festgelegt ist.The default is 0, which indicates that this property is not set.

Ausnahmen

Der angegebene Index der Aktivierreihenfolge liegt nicht zwischen -32768 und 32767.The specified tab index is not between -32768 and 32767.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die TabIndex -Eigenschaft WebControl von verwendet wird, um die Aktivier Reihenfolge von Steuerelementen auf der Seite festzulegen.The following example illustrates how to use the TabIndex property of the WebControl to set the tab order of controls on the page.

Hinweis

Im folgenden Codebeispiel wird das Einzel Datei-Code Modell verwendet und funktioniert möglicherweise nicht ordnungsgemäß, wenn es direkt in eine Code-Behind-Datei kopiert wird.The following code sample uses the single-file code model and may not work correctly if copied directly into a code-behind file. Dieses Codebeispiel muss in eine leere Textdatei mit der Erweiterung ASPX kopiert werden.This code sample must be copied into an empty text file that has an .aspx extension. Weitere Informationen zum Web Forms-Code Modell finden Sie unter ASP.net Web Forms Page Code Model.For more information on the Web Forms code model, see ASP.NET Web Forms Page Code Model.

Wichtig

Dieses Beispiel umfasst ein Textfeld, das Benutzereingaben akzeptiert, die ein potenzielles Sicherheitsrisiko darstellen.This example has a text box that accepts user input, which is a potential security threat. Standardmäßig stellen ASP.NET-Webseiten sicher, dass Benutzereingaben keine Skript- oder HTML-Elemente enthalten.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Weitere Informationen finden Sie unter Übersicht über Skriptangriffe.For more information, see Script Exploits Overview.

<%@ 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 SubmitBtn1_Click(Object sender, EventArgs e)
    {
        SubmitBtn1.TabIndex = 0;
        TextBox1.TabIndex = (short)((TextBox1.Text=="") ? 0 : 
            System.Int32.Parse(TextBox1.Text));
        TextBox2.TabIndex = (short)((TextBox2.Text=="") ? 0 : 
            System.Int32.Parse(TextBox2.Text));
        TextBox3.TabIndex = (short)((TextBox3.Text=="") ? 0 : 
            System.Int32.Parse(TextBox3.Text));
    }

</script>
 

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head2" runat="server">
    <title>Enabled Property Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>

    <h3>TabIndex Property of a Web Control<br /></h3>

    <p>
        Enter a number (1, 2, or 3) in each text box, <br /> 
        click the Submit button to set the TabIndexes, then <br /> 
        click on the page and tab through the page to verify.
    </p>
 
    <p><asp:Button id="SubmitBtn1" OnClick="SubmitBtn1_Click" 
            Text="Submit" runat="server"/>
    </p>

    <p><asp:TextBox id="TextBox1" BackColor="Pink" 
            runat="server"/>
    </p>
    <p><asp:TextBox id="TextBox2" BackColor="LightBlue" 
            runat="server"/>
    </p>
    <p><asp:TextBox id="TextBox3" BackColor="LightGreen" 
            runat="server"/>
    </p>  
     
    </div>
    </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 SubmitBtn1_Click(sender As Object, e As EventArgs)
        SubmitBtn1.TabIndex = 0
        If TextBox1.Text = "" Then
            TextBox1.TabIndex = 0
        Else
            TextBox1.TabIndex = System.Int16.Parse(TextBox1.Text)
        End If
        If TextBox2.Text = "" Then
            TextBox2.TabIndex = 0
        Else
            TextBox2.TabIndex = System.Int16.Parse(TextBox2.Text)
        End If
        If TextBox3.Text = "" Then
            TextBox3.TabIndex = 0
        Else
            TextBox3.TabIndex = System.Int16.Parse(TextBox3.Text)
        End If
    End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head2" runat="server">
    <title>Enabled Property Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>

    <h3>TabIndex Property of a Web Control<br /></h3>

    <p>
        Enter a number (1, 2, or 3) in each text box, <br /> 
        click the Submit button to set the TabIndexes, then <br /> 
        click on the page and tab through the page to verify.
    </p>
 
    <asp:Button id="SubmitBtn1" OnClick="SubmitBtn1_Click" 
        Text="Submit" runat="server"/>
    <p>
        <asp:TextBox id="TextBox1" BackColor="Pink" 
            runat="server"/>
    </p>
    <p>
        <asp:TextBox id="TextBox2" BackColor="LightBlue" 
            runat="server"/>
    </p>
    <p>
        <asp:TextBox id="TextBox3" BackColor="LightGreen" 
            runat="server"/>
    </p>  

    </div>
    </form>
</body>
</html>

Hinweise

Verwenden Sie TabIndex die-Eigenschaft, um den Registerkarten Index eines Webserver-Steuer Elements auf der Web Forms Seite anzugeben oder zu bestimmen.Use the TabIndex property to specify or determine the tab index of a Web server control on the Web Forms page. Wenn Sie die Tab Taste drücken, wird die Reihenfolge, in der die Webserver-Steuerelemente den Fokus TabIndex erhalten, von der-Eigenschaft jedes Steuer Elements bestimmt.When you press the Tab key, the order in which the Web server controls receive focus is determined by the TabIndex property of each control. Wenn eine Seite anfänglich geladen wird, ist das erste Element, das den Tab Fokus erhält, wenn die Taste gedrückt wird, die Adressleiste.When a page is initially loaded, the first item that receives focus when the Tab key is pressed is the address bar. Als nächstes werden die Steuerelemente auf der Web Forms Seite in aufsteigender Reihenfolge auf der Grundlage des Werts TabIndex der-Eigenschaft jedes Steuer Elements angezeigt, beginnend mit dem kleinsten positiven Wert ungleich 0 (null).Next, the controls on the Web Forms page are tabbed to in ascending order, based on the value of the TabIndex property of each control, starting with the smallest positive, nonzero value. Wenn mehrere Steuerelemente denselben Registerkarten Index gemeinsam verwenden, erhalten die Steuerelemente den Fokus in der Reihenfolge, in der Sie auf der Web Forms Seite deklariert werden.If multiple controls share the same tab index, the controls will receive focus in the order they are declared on the Web Forms page. Zum Schluss werden Steuerelemente, die über einen Registerkarten Index von NULL verfügen, in der Reihenfolge, in der Sie deklariert werden, auf denFinally, controls that have a tab index of zero are tabbed to in the order they are declared.

Hinweis

Nur Steuerelemente mit einem Registerkarten Index ungleich NULL werden tabindex das Attribut Rendering.Only controls with a nonzero tab index will render the tabindex attribute.

Sie können ein Webserver Steuerelement aus der Aktivier Reihenfolge entfernen TabIndex , indem Sie die-Eigenschaft auf einen negativen Wert festlegen.You can remove a Web Server control from the tab order by setting the TabIndex property to a negative value.

Hinweis

Diese Eigenschaft wird nur in Internet Explorer 4 und höher unterstützt.This property is supported only in Internet Explorer 4 and later.

Gilt für:

Siehe auch