AutoCompleteType Enumerazione

Riferimento

Definizione

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

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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.
Search	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 l'immissione dei dati, Internet Explorer 5 e versioni successive e altri browser supportano una funzionalità denominata Completamento automatico. Il 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. Invece di digitare di nuovo un valore, l'utente può semplicemente selezionare il valore da questo elenco.

Nota

Non tutti i browser supportano la funzionalità Completamento automatico. Rivolgersi al browser per determinare la compatibilità.

Per controllare il comportamento della funzionalità Completamento automatico per un TextBox controllo, utilizzare la AutoCompleteType proprietà . L'enumerazione AutoCompleteType viene utilizzata 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 le stesse ID pagine diverse. È anche possibile condividere un elenco tra TextBox i controlli in base a una categoria anziché in base a un oggetto ID. 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