AutoCompleteType Énumération

  • Référence

Définition

Espace de noms:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Représente les valeurs qui contrôlent le comportement de la fonctionnalité de saisie semi automatique d'un contrôle TextBox.

public enum class AutoCompleteType
public enum AutoCompleteType
type AutoCompleteType = 
Public Enum AutoCompleteType
Héritage
Object
ValueType
Enum
AutoCompleteType

Champs

BusinessCity 23

Ville d'une catégorie d'adresse d'entreprise.
BusinessCountryRegion 24

Pays/région d'une catégorie d'adresse d'entreprise.
BusinessFax 25

Numéro de télécopie d'une catégorie d'adresse d'entreprise.
BusinessPhone 26

Numéro de téléphone d'une catégorie d'adresse d'entreprise.
BusinessState 27

État d'une catégorie d'adresse d'entreprise.
BusinessStreetAddress 28

Rue d'une catégorie d'adresse d'entreprise.
BusinessUrl 29

URL vers une catégorie de site Web d'entreprise.
BusinessZipCode 30

Code d'une catégorie d'adresse d'entreprise.
Cellular 2

Numéro de téléphone d'une catégorie de téléphone mobile.
Company 3

Nom d'une catégorie d'entreprise.
Department 4

Service d'une catégorie d'entreprise.
Disabled 1

La fonctionnalité de saisie automatique du contrôle TextBox est désactivée.
DisplayName 5

Nom de la catégorie d'utilisateur à afficher.
Email 6

Catégorie d’adresse e-mail de l’utilisateur.
Enabled 32

La fonctionnalité de saisie automatique du contrôle TextBox est activée.
FirstName 7

Catégorie du prénom.
Gender 8

Sexe de la catégorie d'utilisateur.
HomeCity 9

Ville d'une catégorie d'adresse (domicile).
HomeCountryRegion 10

Pays/région d'une catégorie d'adresse (domicile).
HomeFax 11

Numéro de télécopie d'une catégorie d'adresse (domicile).
Homepage 16

URL vers une catégorie de site Web.
HomePhone 12

Numéro de téléphone d'une catégorie d'adresse (domicile).
HomeState 13

État d'une catégorie d'adresse (domicile).
HomeStreetAddress 14

Rue d'une catégorie d'adresse (domicile).
HomeZipCode 15

Code postal d'une catégorie d'adresse (domicile).
JobTitle 17

Catégorie de fonction de l'utilisateur.
LastName 18

Catégorie de nom.
MiddleName 19

Catégorie de deuxième prénom de l'utilisateur.
None 0

Aucune catégorie n'est associée au contrôle TextBox. Tous les contrôles TextBox de la même propriété ID partagent la même liste de valeurs.
Notes 20

Toutes les informations supplémentaires à inclure dans la catégorie de formulaire.
Office 21

L'emplacement de la catégorie de bureau d'entreprise.
Pager 22

Numéro de téléphone d'une catégorie de pagineur.
31

Mots clés avec lesquels rechercher une page Web ou une catégorie de site Web.

Exemples

L’exemple suivant montre comment utiliser l’énumération AutoCompleteType pour spécifier la catégorie de saisie semi-automatique d’un TextBox contrôle.

Important

Cet exemple comprend une zone de texte qui accepte une entrée d'utilisateur, ce qui constitue une menace potentielle pour la sécurité. Par défaut, les pages web ASP.NET vérifient que l’entrée d’utilisateur n’inclut pas de script ou d’éléments HTML. Pour plus d’informations, consultez Vue d’ensemble des attaques 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>

Remarques

Pour faciliter la saisie des données, Internet Explorer 5 et versions ultérieures et certains autres navigateurs prennent en charge une fonctionnalité nommée Saisie semi-automatique. La saisie semi-automatique surveille une zone de texte et stocke une liste des valeurs entrées par l’utilisateur. Lorsque l’utilisateur revient à la zone de texte une autre fois, la liste des valeurs s’affiche. Au lieu de retaper une valeur, l’utilisateur peut simplement sélectionner la valeur dans cette liste.

Notes

Tous les navigateurs ne prennent pas en charge la fonctionnalité de saisie semi-automatique. Vérifiez avec votre navigateur pour déterminer la compatibilité.

Pour contrôler le comportement de la fonctionnalité de saisie semi-automatique d’un TextBox contrôle, utilisez la AutoCompleteType propriété . L’énumération AutoCompleteType est utilisée pour représenter les valeurs que vous pouvez appliquer à la AutoCompleteType propriété .

Par défaut, la AutoCompleteType propriété d’un TextBox contrôle a la valeur AutoCompleteType.None. Avec ce paramètre, le TextBox contrôle partage la liste avec d’autres TextBox contrôles avec le même ID sur différentes pages. Vous pouvez également partager une liste entre des TextBox contrôles en fonction d’une catégorie au lieu de basée sur un ID. Lorsque vous définissez la propriété sur l’une AutoCompleteType des valeurs de catégorie (telles que AutoCompleteType.FirstName ou AutoCompleteType.LastName), tous les TextBox contrôles avec la même catégorie partagent la même liste. Vous pouvez désactiver la fonctionnalité de saisie semi-automatique pour un TextBox contrôle en définissant la AutoCompleteType propriété sur AutoCompleteType.Disabled.

Pour plus d’informations sur la configuration et l’activation de la fonctionnalité de saisie semi-automatique, consultez la documentation de votre navigateur. Par exemple, pour activer la fonctionnalité saisie semi-automatique dans Internet Explorer version 5 ou ultérieure, dans le menu Outils , choisissez Options Internet. Choisissez ensuite l’onglet Contenu . Choisissez le bouton Saisie semi-automatique pour afficher et modifier les options de la fonctionnalité Saisie semi-automatique.

S’applique à

Voir aussi