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

Определение

Пространство имен:: System.Web.UI.WebControls

Сборка:: System.Web.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

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

public enum class AutoCompleteType

public enum AutoCompleteType

type AutoCompleteType =

Public Enum AutoCompleteType

Наследование: Object

ValueType

Enum
AutoCompleteType

Поля

Имя	Значение	Описание
None	0	Категория не связана с элементом TextBox управления. Все TextBox элементы управления с одинаковым списком значений совместно используют один и тот же ID список значений.
Disabled	1	Функция автозаполнения отключена для TextBox элемента управления.
Cellular	2	Номер телефона для категории мобильного телефона.
Company	3	Имя бизнес-категории.
Department	4	Отдел в категории бизнеса.
DisplayName	5	Имя, отображаемое для категории пользователя.
Email	6	Категория адресов электронной почты пользователя.
FirstName	7	Категория имени.
Gender	8	Пол категории пользователей.
HomeCity	9	Город для категории домашних адресов.
HomeCountryRegion	10	Страна или регион для категории домашних адресов.
HomeFax	11	Номер факса для категории домашнего адреса.
HomePhone	12	Номер телефона для категории домашнего адреса.
HomeState	13	Состояние категории домашнего адреса.
HomeStreetAddress	14	Улица для категории домашнего адреса.
HomeZipCode	15	ZIP-код для категории домашнего адреса.
Homepage	16	URL-адрес категории веб-сайта.
JobTitle	17	Категория заголовка задания пользователя.
LastName	18	Категория фамилии.
MiddleName	19	Категория по промежуточному имени пользователя.
Notes	20	Любые дополнительные сведения для включения в категорию формы.
Office	21	Расположение категории бизнес-офисов.
Pager	22	Номер телефона для категории пейджера.
BusinessCity	23	Город для категории бизнес-адресов.
BusinessCountryRegion	24	Страна или регион для категории бизнес-адресов.
BusinessFax	25	Номер факса для категории бизнес-адресов.
BusinessPhone	26	Номер телефона для категории бизнес-адресов.
BusinessState	27	Состояние категории бизнес-адресов.
BusinessStreetAddress	28	Улица для категории бизнес-адресов.
BusinessUrl	29	URL-адрес категории бизнес-веб-сайта.
BusinessZipCode	30	ZIP-код для категории бизнес-адресов.
Search	31	Ключевое слово или ключевые слова, с помощью которых выполняется поиск по веб-странице или категории веб-сайта.
Enabled	32	Функция автозаполнения включена TextBox для элемента управления.

Примеры

В следующем примере показано, как использовать 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 .

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

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

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

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

Обратная связь

Были ли сведения на этой странице полезными?