WebControl.TabIndex Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft den Index der Aktivierreihenfolge des Webserversteuerelements ab oder legt diesen fest.
public:
virtual property short TabIndex { short get(); void set(short value); };public virtual short TabIndex { get; set; }member this.TabIndex : int16 with get, setPublic Overridable Property TabIndex As ShortEigenschaftswert
Der Index der Aktivierreihenfolge des Webserversteuerelements. Der Standardwert ist 0 und gibt an, dass diese Eigenschaft nicht festgelegt ist.
Ausnahmen
Der angegebene Index der Aktivierreihenfolge liegt nicht zwischen -32768 und 32767.
Beispiele
Im folgenden Beispiel wird veranschaulicht, wie die TabIndex -Eigenschaft von WebControl verwendet wird, um die Registerkartenreihenfolge von Steuerelementen auf der Seite festzulegen.
Hinweis
Das folgende Codebeispiel verwendet das Einzeldateicodemodell und funktioniert möglicherweise nicht ordnungsgemäß, 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 ASP.NET Web Forms-Seitencodemodell.
Wichtig
Dieses Beispiel umfasst ein Textfeld, das Benutzereingaben akzeptiert, die ein potenzielles Sicherheitsrisiko darstellen. Standardmäßig stellen ASP.NET-Webseiten sicher, dass Benutzereingaben keine Skript- oder HTML-Elemente enthalten. Weitere Informationen finden Sie unter Übersicht über Skriptangriffe.
<%@ 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 die TabIndex -Eigenschaft, um den Registerkartenindex eines Webserversteuerelements auf der Web Forms-Seite anzugeben oder zu bestimmen. Wenn Sie die Tab TASTE drücken, wird die Reihenfolge, in der die Webserversteuerelemente den Fokus erhalten, durch die TabIndex -Eigenschaft der einzelnen Steuerelemente bestimmt. Wenn eine Seite zuerst geladen wird, ist das erste Element, das den Fokus erhält, wenn die Tab Taste gedrückt wird, die Adressleiste. Als Nächstes werden die Steuerelemente auf der Web Forms-Seite in aufsteigender Reihenfolge tabbed to, basierend auf dem Wert der TabIndex Eigenschaft jedes Steuerelements, beginnend mit dem kleinsten positiven, nichtzero-Wert. Wenn mehrere Steuerelemente denselben Registerkartenindex verwenden, erhalten die Steuerelemente den Fokus in der Reihenfolge, in der sie auf der Web Forms-Seite deklariert werden. Schließlich werden Steuerelemente mit einem Registerkartenindex von 0 in der reihenfolge, in der sie deklariert werden, tabbed to.
Hinweis
Nur Steuerelemente mit einem tabfreien Index werden das Attribut rendern tabindex .
Sie können ein Webserversteuerelement aus der Registerkartenreihenfolge entfernen, indem Sie die TabIndex Eigenschaft auf einen negativen Wert festlegen.
Hinweis
Diese Eigenschaft wird nur in Internet Explorer 4 und höher unterstützt.
