WebControl.TabIndex-Eigenschaft

Artikel
08/20/2007

Ruft den Index der Aktivierreihenfolge des Webserversteuerelements ab oder legt diesen fest.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Public Overridable Property TabIndex As Short
'Usage
Dim instance As WebControl
Dim value As Short

value = instance.TabIndex

instance.TabIndex = value

public virtual short TabIndex { get; set; }

public:
virtual property short TabIndex {
    short get ();
    void set (short value);
}

/** @property */
public short get_TabIndex ()

/** @property */
public void set_TabIndex (short value)

public function get TabIndex () : short

public function set TabIndex (value : short)

Eigenschaftenwert

Der Index der Aktivierreihenfolge des Webserversteuerelements. Der Standardwert ist 0 und gibt an, dass diese Eigenschaft nicht festgelegt ist.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentOutOfRangeException	Der angegebene Index der Aktivierreihenfolge liegt nicht zwischen -32768 und 32767.

Hinweise

Mit der TabIndex-Eigenschaft können Sie den Index der Aktivierreihenfolge eines Webserversteuerelements auf der Web Forms-Seite angeben oder bestimmen. Wenn Sie die Tab-Taste drücken, wird die Reihenfolge, in der Webserversteuerelemente den Fokus erhalten, durch die TabIndex-Eigenschaft jedes Steuerelements bestimmt. Beim erstmaligen Laden einer Seite ist die Adressleiste das erste Element, das den Fokus erhält, wenn die Tab-Taste gedrückt wird. Anschließend werden die Steuerelemente auf der Web Forms-Seite mit der TAB-Taste in aufsteigender Reihenfolge angesteuert. Die Reihenfolge beruht auf dem Wert der TabIndex-Eigenschaft jedes Steuerelements, wobei mit dem kleinsten positiven Wert ungleich 0 (null) begonnen wird. Wenn mehrere Steuerelemente denselben Index der Aktivierreihenfolge aufweisen, erhalten diese den Fokus in der Reihenfolge, in der sie auf der Web Forms-Seite deklariert sind. Abschließend werden die Steuerelemente mit dem Index der Aktivierreihenfolge 0 in der Reihenfolge mit der TAB-Taste angesteuert, in der sie deklariert sind.

Hinweis

Das tabindex-Attribut wird nur von Steuerelementen dargestellt, deren Index der Aktivierreihenfolge ungleich 0 ist.

Sie können ein Webserversteuerelement aus der Aktivierreihenfolge entfernen, indem Sie die TabIndex-Eigenschaft auf einen negativen Wert festlegen.

Hinweis

Diese Eigenschaft wird nur in Internet Explorer ab Version 4 unterstützt.

Beispiel

Im folgenden Beispiel wird veranschaulicht, wie mit der TabIndex-Eigenschaft des WebControl der Index der Aktivierreihenfolge von Steuerelementen auf der Seite festgelegt wird.

Hinweis

Im folgenden Codebeispiel wird das Einzeldatei-Codemodell verwendet. Das Beispiel funktioniert möglicherweise nicht, wenn es direkt in eine CodeBehind-Datei kopiert wird. Dieses Codebeispiel muss in eine leere Textdatei mit einer ASPX-Erweiterung kopiert werden. Weitere Informationen zum Web Forms-Codemodell finden Sie unter Codemodell für ASP.NET-Webseiten.

<%@ Page Language="VB" AutoEventWireup="True" %>

<html>
 <body>
     <h3>TabIndex Property of a Web Control<br></h3>
 
 <script Language="VB" 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>
 
 <form runat=server>
 
     Type in the numbers 1, 2, or 3 as the desired tab order 
     for the following text boxes, <br> 
     Click the Submit button, and <br> 
     Tab through the text boxes to verify:<p>
 
     <asp:Button id="SubmitBtn1" OnClick="SubmitBtn1_Click" Text="Submit" runat="server"/>
     <p>
 
     <asp:TextBox id="TextBox1" BackColor="Pink" runat="server"/>
     <p>
 
     <asp:TextBox id="TextBox2" BackColor="LightBlue" runat="server"/>
     <p>
 
     <asp:TextBox id="TextBox3" BackColor="LightGreen" runat="server"/>
     <p>  
     
 </form>
 
 </body>
 </html>

<%@ Page Language="C#" AutoEventWireup="True" %>

<html>
 <body>
     <h3>TabIndex Property of a Web Control<br></h3>
 
 <script Language="C#" 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>
 
 <form runat=server>
 
     Type in the numbers 1, 2, or 3 as the desired tab order 
     for the following text boxes, <br> 
     Click the Submit button, and <br> 
     Tab through the text boxes to verify:<p>
 
     <asp:Button id="SubmitBtn1" OnClick="SubmitBtn1_Click" Text="Submit" runat="server"/>
     <p>
 
     <asp:TextBox id="TextBox1" BackColor="Pink" runat="server"/>
     <p>
 
     <asp:TextBox id="TextBox2" BackColor="LightBlue" runat="server"/>
     <p>
 
     <asp:TextBox id="TextBox3" BackColor="LightGreen" runat="server"/>
     <p>  
     
 </form>
 
 </body>
 </html>

<%@ Page Language="JScript" AutoEventWireup="True" %>

<html>
 <body>
     <h3>TabIndex Property of a Web Control<br></h3>
 
 <script Language="JSCRIPT" runat="server">
 
    function SubmitBtn1_Click(sender : Object, e : EventArgs){
        SubmitBtn1.TabIndex = 0
        if(TextBox1.Text == "")
            TextBox1.TabIndex = 0
        else
            TextBox1.TabIndex = System.Int16.Parse(TextBox1.Text)
        if(TextBox2.Text == "")
            TextBox2.TabIndex = 0
        else
            TextBox2.TabIndex = System.Int16.Parse(TextBox2.Text)
        if(TextBox3.Text == "")
            TextBox3.TabIndex = 0
        else
            TextBox3.TabIndex = System.Int16.Parse(TextBox3.Text)
    }
 
 </script>
 
 <form runat=server>
 
     Type in the numbers 1, 2, or 3 : the desired tab order 
     for the following text boxes, <br> 
     Click the Submit button, and <br> 
     Tab through the text boxes to verify:<p>
 
     <asp:Button id="SubmitBtn1" OnClick="SubmitBtn1_Click" Text="Submit" runat="server"/>
     <p>
 
     <asp:TextBox id="TextBox1" BackColor="Pink" runat="server"/>
     <p>
 
     <asp:TextBox id="TextBox2" BackColor="LightBlue" runat="server"/>
     <p>
 
     <asp:TextBox id="TextBox3" BackColor="LightGreen" runat="server"/>
     <p>  
     
 </form>
 
 </body>
 </html>

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

WebControl-Klasse
WebControl-Member
System.Web.UI.WebControls-Namespace

Weitere Ressourcen

ASP.NET-Webserversteuerelemente und Browserfunktionen
Syntax des Webserversteuerelements
Entwickeln von benutzerdefinierten ASP.NET-Serversteuerelementen

Freigeben über

WebControl.TabIndex-Eigenschaft

Syntax

Eigenschaftenwert

Ausnahmen

Hinweise

Beispiel

Plattformen

Versionsinformationen

.NET Framework

Siehe auch

Referenz

Weitere Ressourcen

Zusätzliche Ressourcen