Partilhar via


AutoCompleteType Enumeração

Definição

Representa os valores que controlam o comportamento do recurso Preenchimento Automático em um controle TextBox.

public enum class AutoCompleteType
public enum AutoCompleteType
type AutoCompleteType = 
Public Enum AutoCompleteType
Herança
AutoCompleteType

Campos

BusinessCity 23

A cidade para uma categoria de endereços comerciais.

BusinessCountryRegion 24

O país ou a região para uma categoria de endereços comerciais.

BusinessFax 25

O número de fax para uma categoria de endereços comerciais.

BusinessPhone 26

O número de telefone para uma categoria de endereços comerciais.

BusinessState 27

O estado para uma categoria de endereços comerciais.

BusinessStreetAddress 28

A rua para uma categoria de endereços comerciais.

BusinessUrl 29

A URL para uma categoria de site comercial.

BusinessZipCode 30

O CEP para uma categoria de endereços comerciais.

Cellular 2

O número de telefone para uma categoria de telefones celulares.

Company 3

O nome de uma categoria comercial.

Department 4

Um departamento em uma categoria de negócios.

Disabled 1

O recurso Preenchimento Automático está desabilitado para o controle TextBox.

DisplayName 5

O nome a ser exibido para a categoria de usuário.

Email 6

A categoria de endereço de email do usuário.

Enabled 32

O recurso Preenchimento Automático está habilitado para o controle TextBox.

FirstName 7

A categoria de nome.

Gender 8

O sexo da categoria de usuário.

HomeCity 9

A cidade para uma categoria de endereços residenciais.

HomeCountryRegion 10

O país ou a região para uma categoria de endereços residenciais.

HomeFax 11

O número de fax para uma categoria de endereços residenciais.

Homepage 16

A URL para uma categoria de site.

HomePhone 12

O número de telefone para uma categoria de endereços residenciais.

HomeState 13

O estado para uma categoria de endereços residenciais.

HomeStreetAddress 14

A rua para uma categoria de endereços residenciais.

HomeZipCode 15

O CEP para uma categoria de endereços residenciais.

JobTitle 17

A categoria do cargo do usuário.

LastName 18

A categoria de sobrenome.

MiddleName 19

A categoria do sobrenome do usuário.

None 0

Nenhuma categoria é associada ao controle TextBox. Todos os controles TextBox com o mesmo ID compartilham a mesma lista de valores.

Notes 20

Informações complementares a serem incluídas na categoria de formulário.

Office 21

O local da categoria de escritórios comerciais.

Pager 22

O número de telefone para uma categoria de pagers.

31

As palavras-chave com as quais uma página da Web ou uma categoria de site será pesquisada.

Exemplos

O exemplo a seguir demonstra como usar a AutoCompleteType enumeração para especificar a categoria Preenchimento Automático para um TextBox controle .

Importante

Este exemplo tem uma caixa de texto que aceita a entrada do usuário, que é uma possível ameaça à segurança. Por padrão, ASP.NET páginas da Web validam que a entrada do usuário não inclui elementos html ou script. Para obter mais informações, consulte Visão geral de explorações de script.


<%@ 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>

Comentários

Para ajudar na entrada de dados, o Internet Explorer 5 e posterior e alguns outros navegadores dão suporte a um recurso chamado Preenchimento Automático. O Preenchimento Automático monitora uma caixa de texto e armazena uma lista dos valores que o usuário inseriu. Quando o usuário retorna à caixa de texto outra vez, a lista de valores é exibida. Em vez de redigitar um valor, o usuário pode simplesmente selecionar o valor nessa lista.

Observação

Nem todos os navegadores dão suporte ao recurso preenchimento automático. Verifique com o navegador para determinar a compatibilidade.

Para controlar o comportamento do recurso preenchimento automático para um TextBox controle, use a AutoCompleteType propriedade . A AutoCompleteType enumeração é usada para representar os valores que você pode aplicar à AutoCompleteType propriedade .

Por padrão, a AutoCompleteType propriedade de um TextBox controle é definida AutoCompleteType.Nonecomo . Com essa configuração, o TextBox controle compartilha a lista com outros TextBox controles com o mesmo ID em páginas diferentes. Você também pode compartilhar uma lista entre TextBox controles com base em uma categoria em vez de com base em um ID. Quando você define a AutoCompleteType propriedade como um dos valores de categoria (como AutoCompleteType.FirstName ou AutoCompleteType.LastName), todos os TextBox controles com a mesma categoria compartilham a mesma lista. Você pode desabilitar o recurso preenchimento automático para um TextBox controle definindo a AutoCompleteType propriedade AutoCompleteType.Disabledcomo .

Consulte a documentação do navegador para obter detalhes sobre como configurar e habilitar o recurso preenchimento automático. Por exemplo, para habilitar o recurso preenchimento automático no Internet Explorer versão 5 ou posterior, no menu Ferramentas , escolha Opções da Internet. Em seguida, escolha a guia Conteúdo . Escolha o botão Preenchimento Automático para exibir e modificar as opções do recurso Preenchimento Automático.

Aplica-se a

Confira também