AutoCompleteType Enumeração

Referência

Definição

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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: Object

ValueType

Enum
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.
Search	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 AutoComplete para um TextBox controle.

Importante

Este exemplo tem uma caixa de texto que aceita a entrada do usuário, que é uma potencial 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 AutoComplete 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 redigir 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 AutoComplete 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 como AutoCompleteType.None. 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 como AutoCompleteType.Disabled.

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 de Internet. Em seguida, escolha a guia Conteúdo . Escolha o botão Preenchimento Automático para exibir e modificar opções para o recurso Preenchimento Automático.

Aplica-se a