WebControl.TabIndex Свойство

Определение

Возвращает или задает индекс перехода по клавише Tab для серверного веб-элемента управления.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

Значение свойства

Индекс перехода по клавише Tab для серверного веб-элемента управления.The tab index of the Web server control. Значение по умолчанию — "0", указывающее, что это свойство не задано.The default is 0, which indicates that this property is not set.

Исключения

Указанный индекс перехода по клавише TAB не выходит за пределы диапазона от -32768 до 32767.The specified tab index is not between -32768 and 32767.

Примеры

В следующем примере показано, как использовать TabIndex свойство WebControl объекта для задания последовательности вкладок элементов управления на странице.The following example illustrates how to use the TabIndex property of the WebControl to set the tab order of controls on the page.

Примечание

В следующем примере кода используется модель кода с одним файлом, и она может работать неправильно, если копировать их непосредственно в файл кода программной части.The following code sample uses the single-file code model and may not work correctly if copied directly into a code-behind file. Этот пример кода необходимо скопировать в пустой текстовый файл с расширением. aspx.This code sample must be copied into an empty text file that has an .aspx extension. Дополнительные сведения о модели кода веб-форм см. в разделе модель кода страницы веб-форм ASP.NET.For more information on the Web Forms code model, see ASP.NET Web Forms Page Code Model.

Важно!

В этом примере имеется текстовое поле, принимающее вводимые пользователем данные, что является потенциальной угрозой безопасности.This example has a text box that accepts user input, which is a potential security threat. По умолчанию данные, вводимые пользователем на веб-страницах ASP.NET, проверяются на наличие скриптов и HTML-элементов.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Дополнительные сведения см. в разделе Общие сведения об использовании сценариев.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>

Комментарии

TabIndex Используйте свойство, чтобы указать или определить индекс вкладки элемента управления веб-сервера на странице веб-форм.Use the TabIndex property to specify or determine the tab index of a Web server control on the Web Forms page. При нажатии Tab клавиши порядок, в котором элемент управления веб-сервером получает фокус, определяется TabIndex свойством каждого элемента управления.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. При начальной загрузке страницы первый элемент, который получает фокус при Tab нажатии клавиши, является адресной строкой.When a page is initially loaded, the first item that receives focus when the Tab key is pressed is the address bar. Далее элементы управления на странице веб-форм отображаются в порядке возрастания на основе значения TabIndex свойства каждого элемента управления, начиная с наименьшего положительного ненулевого значения.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. Если несколько элементов управления совместно используют один и тот же индекс вкладки, элементы управления будут получать фокус в том порядке, в котором они объявляются на странице веб-форм.If multiple controls share the same tab index, the controls will receive focus in the order they are declared on the Web Forms page. Наконец, элементы управления с нулевым индексом табуляции указываются в порядке их объявления.Finally, controls that have a tab index of zero are tabbed to in the order they are declared.

Примечание

tabindex Атрибут будет отображен только для элементов управления с ненулевым индексом табуляции.Only controls with a nonzero tab index will render the tabindex attribute.

Элемент управления веб-сервера можно удалить из последовательности табуляции, задав TabIndex для свойства отрицательное значение.You can remove a Web Server control from the tab order by setting the TabIndex property to a negative value.

Примечание

Это свойство поддерживается только в Internet Explorer 4 и более поздних версиях.This property is supported only in Internet Explorer 4 and later.

Применяется к

Дополнительно