WebControl.TabIndex Właściwość

Definicja

Pobiera lub ustawia indeks tabulacji kontrolki serwera sieci Web.

C#
public virtual short TabIndex { get; set; }

Wartość właściwości

Indeks karty kontrolki serwera sieci Web. Wartość domyślna to 0, która wskazuje, że ta właściwość nie jest ustawiona.

Wyjątki

Określony indeks kart nie zawiera się między -32768 a 32767.

Przykłady

W poniższym przykładzie pokazano, jak używać TabIndex właściwości , WebControl aby ustawić kolejność tabulacji kontrolek na stronie.

Uwaga

Poniższy przykładowy kod używa modelu kodu z jednym plikiem i może nie działać poprawnie, jeśli został skopiowany bezpośrednio do pliku za pomocą kodu. Ten przykładowy kod musi zostać skopiowany do pustego pliku tekstowego z rozszerzeniem .aspx. Aby uzyskać więcej informacji na temat modelu kodu formularzy internetowych, zobacz ASP.NET Model kodu strony formularzy internetowych.

Ważne

Ten przykład zawiera pole tekstowe, które akceptuje dane wejściowe użytkownika, co jest potencjalnym zagrożeniem bezpieczeństwa. Domyślnie ASP.NET strony sieci Web sprawdzają, czy dane wejściowe użytkownika nie zawierają skryptów ani elementów HTML. Aby uzyskać więcej informacji, zobacz Script Exploits Overview (Omówienie luk w zabezpieczeniach skryptów).

ASP.NET (C#)
<%@ 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>

Uwagi

TabIndex Użyj właściwości , aby określić lub określić indeks kart kontrolki serwera sieci Web na stronie formularzy sieci Web. Po naciśnięciu klawisza Tab kolejność, w jakiej kontrolki serwera sieci Web odbiera fokus, jest określana przez TabIndex właściwość każdej kontrolki. Po początkowym załadowaniu strony pierwszy element, który odbiera fokus po naciśnięciu klawisza Tab , jest paskiem adresu. Następnie kontrolki na stronie formularzy sieci Web są tabulatorami w kolejności rosnącej na podstawie wartości TabIndex właściwości każdej kontrolki, począwszy od najmniejszej dodatniej, niezerowej wartości. Jeśli wiele kontrolek współużytruje ten sam indeks tabulacji, kontrolki będą otrzymywać fokus w kolejności deklarowanej na stronie formularzy sieci Web. Na koniec kontrolki, które mają indeks tabulacji zero, są tabulatorami w kolejności, w której są deklarowane.

Uwaga

Atrybut renderuje tabindex tylko kontrolki z indeksem tabulacji niezerowym.

Kontrolkę Serwera sieci Web można usunąć z kolejności tabulacji, ustawiając TabIndex właściwość na wartość ujemną.

Uwaga

Ta właściwość jest obsługiwana tylko w programie Internet Explorer 4 lub nowszym.

Dotyczy

Produkt Wersje
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Zobacz też