AutoCompleteType Enumerazione

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Rappresenta i valori che controllano il comportamento della funzionalità di completamento automatico in un controllo TextBox.

public enum class AutoCompleteType
public enum AutoCompleteType
type AutoCompleteType = 
Public Enum AutoCompleteType
Ereditarietà
Object
ValueType
Enum
AutoCompleteType

Campi

BusinessCity 23

Città per una categoria indirizzi di società.
BusinessCountryRegion 24

Paese/provincia per una categoria indirizzo di società.
BusinessFax 25

Numero di fax per una categoria indirizzi di società.
BusinessPhone 26

Numero di telefono per una categoria indirizzi di società.
BusinessState 27

Stato per una categoria indirizzi di società.
BusinessStreetAddress 28

Strada per una categoria indirizzi di società.
BusinessUrl 29

URL per una categoria siti Web aziendali.
BusinessZipCode 30

CAP per una categoria indirizzi di società.
Cellular 2

Numero di telefono per una categoria numeri di cellulari.
Company 3

Nome per una categoria società.
Department 4

Reparto in una categoria società.
Disabled 1

La funzionalità di completamento automatico è disabilitata per il controllo TextBox.
DisplayName 5

Nome da visualizzare per la categoria utenti.
Email 6

Categoria degli indirizzi di posta elettronica dell'utente.
Enabled 32

La funzionalità di completamento automatico è abilitata per il controllo TextBox.
FirstName 7

Prima categoria del nome.
Gender 8

Sesso per la categoria dell'utente.
HomeCity 9

Città per una categoria indirizzi privati.
HomeCountryRegion 10

Paese/provincia per una categoria indirizzi privati.
HomeFax 11

Numero di fax per una categoria indirizzi privati.
Homepage 16

URL per una categoria siti Web.
HomePhone 12

Numero di telefono per una categoria indirizzi privati.
HomeState 13

Stato per una categoria indirizzi privati.
HomeStreetAddress 14

Strada per una categoria indirizzi privati.
HomeZipCode 15

CAP per una categoria indirizzi privati.
JobTitle 17

Categoria delle qualifiche professionali dell'utente.
LastName 18

Categoria del cognome.
MiddleName 19

Categoria del secondo nome dell'utente.
None 0

Non è associata alcuna categoria al controllo TextBox. Tutti i controlli TextBox con la stessa proprietà ID condividono lo stesso elenco di valori.
Notes 20

Qualsiasi informazione aggiuntiva da includere nella categoria del form.
Office 21

Posizione per la categoria uffici di società.
Pager 22

Numero di telefono per una categoria cercapersone.
31

Parola o parole chiave in base alle quali effettuare la ricerca in una categoria pagine Web o siti Web.

Esempio

Nell'esempio seguente viene illustrato come utilizzare l'enumerazione AutoCompleteType per specificare la categoria Completamento automatico per un TextBox controllo .

Importante

L'esempio include una casella di testo che accetta l'input dell'utente e rappresenta quindi una potenziale minaccia alla sicurezza. Per impostazione predefinita, le pagine Web ASP.NET verificano che l'input dell'utente non includa script o elementi HTML. Per altre informazioni, vedere Cenni preliminari sugli attacchi tramite 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>

Commenti

Per facilitare la voce dei dati, Internet Explorer 5 e versioni successive e alcuni altri browser supportano una funzionalità denominata Completamento automatico. Completamento automatico monitora una casella di testo e archivia un elenco dei valori immessi dall'utente. Quando l'utente torna alla casella di testo un'altra volta, viene visualizzato l'elenco di valori. Anziché digitare un valore, l'utente può semplicemente selezionare il valore da questo elenco.

Nota

Non tutti i browser supportano la funzionalità Completamento automatico. Controllare con il browser per determinare la compatibilità.

Per controllare il comportamento della funzionalità Completamento automatico per un TextBox controllo, usare la AutoCompleteType proprietà . L'enumerazione AutoCompleteType viene usata per rappresentare i valori che è possibile applicare alla AutoCompleteType proprietà.

Per impostazione predefinita, la AutoCompleteType proprietà per un TextBox controllo è impostata su AutoCompleteType.None. Con questa impostazione, il TextBox controllo condivide l'elenco con altri TextBox controlli con gli stessi ID in pagine diverse. È anche possibile condividere un elenco tra TextBox i controlli in base a una categoria anziché in base a un IDoggetto . Quando si imposta la AutoCompleteType proprietà su uno dei valori di categoria (ad esempio AutoCompleteType.FirstName o AutoCompleteType.LastName), tutti i TextBox controlli con la stessa categoria condividono lo stesso elenco. È possibile disabilitare la funzionalità Completamento automatico per un TextBox controllo impostando la AutoCompleteType proprietà su AutoCompleteType.Disabled.

Per informazioni dettagliate sulla configurazione e sull'abilitazione della funzionalità Completamento automatico, vedere la documentazione del browser. Ad esempio, per abilitare la funzionalità Completamento automatico in Internet Explorer versione 5 o successiva, scegliere Opzioni Internet dal menu Strumenti. Scegliere quindi la scheda Contenuto . Scegliere il pulsante Completamento automatico per visualizzare e modificare le opzioni per la funzionalità Completamento automatico.

Si applica a

Vedi anche