Taal

TextBox.AutoCompleteType Eigenschap

Definitie

Naamruimte:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Hiermee wordt een waarde opgehaald of ingesteld die het gedrag van automatisch aanvullen van het TextBox besturingselement aangeeft.

public:
 virtual property System::Web::UI::WebControls::AutoCompleteType AutoCompleteType { System::Web::UI::WebControls::AutoCompleteType get(); void set(System::Web::UI::WebControls::AutoCompleteType value); };
[System.Web.UI.Themeable(false)]
public virtual System.Web.UI.WebControls.AutoCompleteType AutoCompleteType { get; set; }
[<System.Web.UI.Themeable(false)>]
member this.AutoCompleteType : System.Web.UI.WebControls.AutoCompleteType with get, set
Public Overridable Property AutoCompleteType As AutoCompleteType

Waarde van eigenschap

AutoCompleteType

Een van de AutoCompleteType opsommingswaarden, waarmee het gedrag van Automatisch aanvullen voor het TextBox besturingselement wordt aangegeven. De standaardwaarde is None.

Kenmerken
ThemeableAttribute

Uitzonderingen

ArgumentOutOfRangeException

De geselecteerde waarde is geen van de AutoCompleteType opsommingswaarden.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de AutoCompleteType opsomming gebruikt om de categorie Automatisch aanvullen voor een TextBox besturingselement op te geven.

Important

Dit voorbeeld heeft een tekstvak dat gebruikersinvoer accepteert. Dit is een mogelijke beveiligingsrisico. Standaard valideren ASP.NET webpagina's dat gebruikersinvoer geen script- of HTML-elementen bevat. Zie Overzicht van Script Exploits voor meer informatie.


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

Opmerkingen

Om u te helpen bij het invoeren van gegevens, ondersteunen Microsoft Internet Explorer 5 en hoger en sommige andere browsers een functie die wordt aangeduid als Automatisch aanvullen. Met Automatisch aanvullen wordt een tekstvak bewaakt en wordt een lijst met waarden gemaakt die door de gebruiker zijn ingevoerd. Wanneer de gebruiker op een later tijdstip terugkeert naar het tekstvak, wordt de lijst weergegeven. In plaats van een eerder ingevoerde waarde opnieuw te typen, kan de gebruiker gewoon de waarde in deze lijst selecteren. Gebruik de AutoCompleteType eigenschap om het gedrag van de functie Automatisch aanvullen voor een TextBox besturingselement te beheren. De System.Web.UI.WebControls.AutoCompleteType opsomming wordt gebruikt om de waarden weer te geven die u op de AutoCompleteType eigenschap kunt toepassen.

Note

Niet alle browsers ondersteunen de functie Automatisch aanvullen. Neem contact op met uw browser om de compatibiliteit te bepalen.

De eigenschap voor een AutoCompleteType besturingselement is standaard TextBox ingesteld op AutoCompleteType.None. Met deze instelling deelt het TextBox besturingselement de lijst met andere TextBox besturingselementen met dezelfde ID eigenschap op verschillende pagina's. U kunt ook een lijst delen tussen TextBox besturingselementen op basis van een categorie, in plaats van een ID eigenschap. Wanneer u de AutoCompleteType eigenschap instelt op een van de categoriewaarden (zoals AutoCompleteType.FirstName, AutoCompleteType.LastNameenzovoort), delen alle TextBox besturingselementen met dezelfde categorie dezelfde lijst. U kunt de functie Automatisch aanvullen voor een TextBox besturingselement uitschakelen door de AutoCompleteType eigenschap in te stellen op AutoCompleteType.Disabled.

Raadpleeg de browserdocumentatie voor meer informatie over het configureren en inschakelen van de functie Automatisch aanvullen. Als u bijvoorbeeld de functie Automatisch aanvullen wilt inschakelen in Internet Explorer versie 5 of hoger, selecteert u Internetopties in het menu Tools, en selecteer vervolgens het tabblad Content. Klik op de knop AutoComplete om de verschillende browseropties voor de functie Automatisch aanvullen weer te geven en te wijzigen.

Zie Aanvullen in HTML-formulieren voor meer informatie over de functie Automatisch aanvullen in Internet Explorer.

Deze eigenschap kan niet worden ingesteld op thema's of opmaakmodellen. Zie ThemeableAttribute en ASP.NET Thema's en skins voor meer informatie.

Van toepassing op

Zie ook