AutoCompleteType Enumeração

Definição

Espaço de Nomes:
System.Web.UI.WebControls
Assemblagem:
System.Web.dll

Representa os valores que controlam o comportamento da funcionalidade de AutoCompletar num TextBox controlo.

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

Campos

Name Valor Description
None 0

Nenhuma categoria está associada ao TextBox controlo. Todos TextBox os controlos com o mesmo ID partilham a mesma lista de valores.
Disabled 1

A funcionalidade de AutoCompletar está desativada para o TextBox controlo.
Cellular 2

O número de telefone para uma categoria de telemóvel.
Company 3

O nome de uma categoria empresarial.
Department 4

Um departamento dentro de uma categoria empresarial.
DisplayName 5

O nome a mostrar para a categoria de utilizador.
Email 6

A categoria do endereço de email do utilizador.
FirstName 7

A categoria do primeiro nome.
Gender 8

O género da categoria de utilizador.
HomeCity 9

A cidade para uma categoria de morada residencial.
HomeCountryRegion 10

O país/região para a categoria de morada residencial.
HomeFax 11

O número de fax para uma categoria de morada residencial.
HomePhone 12

O número de telefone para a categoria de morada residencial.
HomeState 13

O estado para uma categoria de endereço residencial.
HomeStreetAddress 14

A rua para uma categoria de endereço residencial.
HomeZipCode 15

O código postal de uma categoria de morada residencial.
Homepage 16

O URL de uma categoria de site.
JobTitle 17

A categoria do cargo do utilizador.
LastName 18

A categoria do apelido.
MiddleName 19

A categoria do nome do meio do utilizador.
Notes 20

Qualquer informação suplementar para incluir na categoria de formulários.
Office 21

A localização da categoria de escritórios empresariais.
Pager 22

O número de telefone de uma categoria de pagers.
BusinessCity 23

A cidade para uma categoria de morada comercial.
BusinessCountryRegion 24

O país/região para uma categoria de morada comercial.
BusinessFax 25

O número de fax para uma categoria de morada comercial.
BusinessPhone 26

O número de telefone para uma categoria de morada comercial.
BusinessState 27

O estado para uma categoria de morada comercial.
BusinessStreetAddress 28

A rua para uma categoria de morada comercial.
BusinessUrl 29

A URL de uma categoria de site empresarial.
BusinessZipCode 30

O código postal de uma categoria de morada comercial.
31

A palavra-chave ou palavras-chave com as quais pesquisar uma página Web ou categoria de site.
Enabled 32

A funcionalidade AutoComplete está ativada para o TextBox controlo.

Exemplos

O exemplo seguinte demonstra como usar a AutoCompleteType enumeração para especificar a categoria AutoComplete para um TextBox controlo.

Importante

Este exemplo tem uma caixa de texto que aceita a entrada do utilizador, o que constitui uma potencial ameaça à segurança. Por defeito, as páginas Web do ASP.NET validam que a entrada do utilizador não inclui elementos de script ou HTML. Para mais informações, consulte Visão Geral dos Exploits de Scripts.


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

Observações

Para ajudar na introdução de dados, o Internet Explorer 5 e outros navegadores posteriores e alguns outros suportam uma funcionalidade chamada AutoComplete. O AutoComplete monitoriza uma caixa de texto e armazena uma lista dos valores que o utilizador introduziu. Quando o utilizador regressa à caixa de texto outra vez, a lista de valores é exibida. Em vez de reescrever um valor, o utilizador pode simplesmente selecionar o valor dessa lista.

Note

Nem todos os navegadores suportam a funcionalidade de AutoCompletamento. Verifique com o seu navegador para verificar a compatibilidade.

Para controlar o comportamento da funcionalidade AutoComplete de um TextBox controlo, utiliza-se a AutoCompleteType propriedade. A AutoCompleteType enumeração é usada para representar os valores que pode aplicar à AutoCompleteType propriedade.

Por defeito, a AutoCompleteType propriedade de um TextBox controlo é definida para AutoCompleteType.None. Com esta definição, o controlo TextBox partilha a lista com outros TextBox controlos iguais ID em diferentes páginas. Também pode partilhar uma lista entre TextBox controlos baseada numa categoria em vez de baseada num ID. Quando defines a AutoCompleteType propriedade para um dos valores de categoria (como AutoCompleteType.FirstName ou AutoCompleteType.LastName), todos TextBox os controlos com a mesma categoria partilham a mesma lista. Pode desativar a funcionalidade de AutoCompletar para um TextBox controlo definindo a AutoCompleteType propriedade para AutoCompleteType.Disabled.

Consulte a documentação do seu navegador para detalhes sobre como configurar e ativar a funcionalidade de AutoCompletamento. Por exemplo, para ativar a funcionalidade de AutoCompletar na versão 5 ou Internet Explorer posterior, no menu Tools, escolha Opções de Internet. Depois escolhe o separador Conteúdo . Escolha o botão AutoCompletar para visualizar e modificar as opções da funcionalidade AutoCompletar.

Aplica-se a

Ver também