AutoCompleteType Перечисление

Определение

Представляет значения, управляющие поведением функции автозавершения в элементе управления TextBox.

public enum class AutoCompleteType
public enum AutoCompleteType
type AutoCompleteType = 
Public Enum AutoCompleteType
Наследование
AutoCompleteType

Поля

BusinessCity 23

Город для категории рабочих адресов.

BusinessCountryRegion 24

Страна или регион для категории рабочих адресов.

BusinessFax 25

Номер факса для категории рабочих адресов.

BusinessPhone 26

Номер телефона для категории рабочих адресов.

BusinessState 27

Область для категории рабочих адресов.

BusinessStreetAddress 28

Улица для категории рабочих адресов.

BusinessUrl 29

URL-адрес для категории рабочих веб-узелов.

BusinessZipCode 30

Почтовый индекс для категории рабочих адресов.

Cellular 2

Номер телефона для категории мобильных телефонов.

Company 3

Имя рабочей категории.

Department 4

Отдел в рабочей категории.

Disabled 1

Для элемента управления TextBox функция автозаполнения отключена.

DisplayName 5

Имя, отображаемое для категории пользователей.

Email 6

Категория адресов электронной почты пользователей.

Enabled 32

Для элемента управления TextBox функция автозаполнения включена.

FirstName 7

Первая категории имени.

Gender 8

Пол в категории пользователей.

HomeCity 9

Город для категории домашних адресов.

HomeCountryRegion 10

Страна или регион для категории домашних адресов.

HomeFax 11

Номер факса для категории домашних адресов.

Homepage 16

URL-адрес для категории веб-узелов.

HomePhone 12

Номер телефона для категории домашних адресов.

HomeState 13

Область для категории домашних адресов.

HomeStreetAddress 14

Улица для категории домашних адресов.

HomeZipCode 15

Почтовый индекс для категории домашних адресов.

JobTitle 17

Категория должностей пользователя.

LastName 18

Последняя категории имени.

MiddleName 19

Категория отчеств пользователя.

None 0

С элементом управления TextBox не связана ни одна категория. Все элементы управления TextBox с одинаковым свойством ID используют один и тот же список значений.

Notes 20

Любые дополнительные сведения, которые нужно включить в категорию форм.

Office 21

Категория расположений офисов предприятий.

Pager 22

Номер телефона для категории пейджеров.

31

Ключевое слово или ключевые слова, используемые для поиска в категории веб-страниц или веб-узелов.

Примеры

В следующем примере показано, как использовать перечисление AutoCompleteType для указания категории автозаполнения для TextBox элемента управления .

Важно!

В этом примере имеется текстовое поле, принимающее вводимые пользователем данные, что является потенциальной угрозой безопасности. По умолчанию данные, вводимые пользователем на веб-страницах ASP.NET, проверяются на наличие скриптов и HTML-элементов. Дополнительные сведения см. в разделе Общие сведения об использовании сценариев.


<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>AutoCompleteType example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <!-- You need to enable the AutoComplete feature on -->
      <!-- a browser that supports it (such as Internet   -->
      <!-- Explorer 5.0 and later) for this sample to     -->
      <!-- work. The AutoComplete lists are created after -->
      <!-- the Submit button is clicked.                  -->
    
      <h3>AutoCompleteType example</h3>
    
      Enter values in the text boxes and click the Submit <br/>
      button. <br/><br/> 
    
      <!-- The following TextBox controls have different  -->
      <!-- categories assigned to their AutoCompleteType  -->
      <!-- properties.                                    -->
      First Name:<br/>
      <asp:textbox id="FirstNameTextBox"
        autocompletetype="FirstName" 
        runat="server"/>
      <br/>
        
      Last Name:<br/>   
      <asp:textbox id="LastNameTextBox"
        autocompletetype="LastName" 
        runat="server"/>
      <br/>
      
      Email:<br/>   
      <asp:textbox id="EmailTextBox"
        autocompletetype="Email" 
        runat="server"/>
      <br/>
      
      <!-- The following TextBox controls have the same   -->
      <!-- categories assigned to their AutoCompleteType  -->
      <!-- properties. They share the same AutoComplete   -->
      <!-- list.                                          -->
      Phone Line #1:<br/>
      <asp:textbox id="Phone1TextBox"
        autocompletetype="HomePhone" 
        runat="server"/>
      <br/>
      
      Phone Line #2:<br/>
      <asp:textbox id="Phone2TextBox"
        autocompletetype="HomePhone" 
        runat="server"/>
      <br/>

    
      <!-- The following TextBox control has its          -->
      <!-- AutoCompleteType property set to               -->
      <!-- AutoCompleteType.None. All TextBox controls    -->
      <!-- with the same ID across different pages share  -->
      <!-- the same AutoComplete list.                    -->
      Category:<br/>   
      <asp:textbox id="CategoryTextBox"
        autocompletetype="None" 
        runat="server"/>
      <br/>
        
      <!-- The following TextBox control has the          -->
      <!-- AutoComplete feature disabled.                 -->
      Comments:<br/>   
      <asp:textbox id="CommentsTextBox"
        autocompletetype="Disabled" 
        runat="server"/>
      <br/>
      <br/><br/>  
      
      <asp:button id="SubmitButton"
        text="Submit"
        runat="Server"/>
    
    </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">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>AutoCompleteType example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <!-- You need to enable the AutoComplete feature on -->
      <!-- a browser that supports it (such as Internet   -->
      <!-- Explorer 5.0 and later) for this sample to     -->
      <!-- work. The AutoComplete lists are created after -->
      <!-- the Submit button is clicked.                  -->
    
      <h3>AutoCompleteType example</h3>
    
      Enter values in the text boxes and click the Submit <br/>
      button. <br/><br/> 
    
      <!-- The following TextBox controls have different  -->
      <!-- categories assigned to their AutoCompleteType  -->
      <!-- properties.                                    -->
      First Name:<br/>
      <asp:textbox id="FirstNameTextBox"
        autocompletetype="FirstName" 
        runat="server"/>
      <br/>
        
      Last Name:<br/>   
      <asp:textbox id="LastNameTextBox"
        autocompletetype="LastName" 
        runat="server"/>
      <br/>
      
      Email:<br/>   
      <asp:textbox id="EmailTextBox"
        autocompletetype="Email" 
        runat="server"/>
      <br/>
      
      <!-- The following TextBox controls have the same   -->
      <!-- categories assigned to their AutoCompleteType  -->
      <!-- properties. They share the same AutoComplete   -->
      <!-- list.                                          -->
      Phone Line #1:<br/>
      <asp:textbox id="Phone1TextBox"
        autocompletetype="HomePhone" 
        runat="server"/>
      <br/>
      
      Phone Line #2:<br/>
      <asp:textbox id="Phone2TextBox"
        autocompletetype="HomePhone" 
        runat="server"/>
      <br/>

    
      <!-- The following TextBox control has its          -->
      <!-- AutoCompleteType property set to               -->
      <!-- AutoCompleteType.None. All TextBox controls    -->
      <!-- with the same ID across different pages share  -->
      <!-- the same AutoComplete list.                    -->
      Category:<br/>   
      <asp:textbox id="CategoryTextBox"
        autocompletetype="None" 
        runat="server"/>
      <br/>
        
      <!-- The following TextBox control has the          -->
      <!-- AutoComplete feature disabled.                 -->
      Comments:<br/>   
      <asp:textbox id="CommentsTextBox"
        autocompletetype="Disabled" 
        runat="server"/>
      <br/>
      <br/><br/>  
      
      <asp:button id="SubmitButton"
        text="Submit"
        runat="Server"/>
    
    </form>
  </body>
</html>

Комментарии

Чтобы упростить ввод данных, Internet Explorer 5 и более поздних версий и некоторые другие браузеры поддерживают функцию автозаполнения. Автозавершение отслеживает текстовое поле и сохраняет список значений, введенных пользователем. Когда пользователь возвращается в текстовое поле в другой раз, отображается список значений. Вместо повторного создания значения пользователь может просто выбрать значение из этого списка.

Примечание

Не все браузеры поддерживают функцию автозаполнения. Чтобы определить совместимость, обратитесь к браузеру.

Чтобы управлять поведением функции автозаполнения для TextBox элемента управления, используйте AutoCompleteType свойство . Перечисление AutoCompleteType используется для представления значений, которые можно применить к свойству AutoCompleteType .

По умолчанию свойству AutoCompleteTypeTextBox элемента управления присвоено значение AutoCompleteType.None. При использовании этого параметра элемент управления предоставляет общий TextBox доступ к списку с другими TextBox элементами ID управления на разных страницах. Вы также можете совместно использовать список между TextBox элементами управления на основе категории, а не на IDоснове . Если для свойства задано AutoCompleteType одно из значений категории (например AutoCompleteType.FirstName , или AutoCompleteType.LastName), все TextBox элементы управления с одной категорией используют один и тот же список. Функцию автозаполнения для TextBox элемента управления можно отключить, задав свойству AutoCompleteType значение AutoCompleteType.Disabled.

Дополнительные сведения о настройке и включении функции автозаполнения см. в документации по браузеру. Например, чтобы включить функцию автозаполнения в Internet Explorer версии 5 или более поздней, в меню Сервис выберите пункт Свойства браузера. Затем перейдите на вкладку Содержимое . Нажмите кнопку Автозавершение , чтобы просмотреть и изменить параметры функции автозаполнения.

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

См. также раздел