AutoCompleteType Výčet

Reference

Definice

Obor názvů:: System.Web.UI.WebControls

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Představuje hodnoty, které řídí chování funkce automatického dokončování v ovládacím prvku TextBox .

public enum class AutoCompleteType

public enum AutoCompleteType

type AutoCompleteType =

Public Enum AutoCompleteType

Dědičnost: Object

ValueType

Enum
AutoCompleteType

Pole

BusinessCity	23	Město pro kategorii firemní adresy.
BusinessCountryRegion	24	Země/oblast pro kategorii firemní adresy.
BusinessFax	25	Číslo faxu pro kategorii obchodní adresy.
BusinessPhone	26	Telefonní číslo pro kategorii firemní adresy.
BusinessState	27	Stav pro kategorii obchodní adresy.
BusinessStreetAddress	28	Ulice pro kategorii firemní adresy.
BusinessUrl	29	Adresa URL obchodního webu kategorie.
BusinessZipCode	30	PSČ pro kategorii firemní adresy.
Cellular	2	Telefonní číslo kategorie mobilního telefonu.
Company	3	Název obchodní kategorie.
Department	4	Oddělení v rámci obchodní kategorie.
Disabled	1	Funkce automatického dokončování je pro ovládací prvek zakázaná TextBox .
DisplayName	5	Název, který se má zobrazit pro kategorii uživatele.
Email	6	Kategorie e-mailové adresy uživatele
Enabled	32	Pro ovládací prvek je povolená funkce automatického TextBox dokončování.
FirstName	7	Kategorie křestní jméno.
Gender	8	Pohlaví kategorie uživatele.
HomeCity	9	Město pro kategorii domovské adresy.
HomeCountryRegion	10	Země/oblast pro kategorii domovské adresy.
HomeFax	11	Číslo faxu pro kategorii domovské adresy.
Homepage	16	Adresa URL pro kategorii webu.
HomePhone	12	Telefonní číslo pro kategorii domovské adresy.
HomeState	13	Stav pro kategorii domovské adresy.
HomeStreetAddress	14	Ulice pro kategorii domovské adresy.
HomeZipCode	15	PSČ pro kategorii domovské adresy.
JobTitle	17	Kategorie pracovní pozice uživatele
LastName	18	Kategorie příjmení.
MiddleName	19	Kategorie prostředního jména uživatele.
None	0	K ovládacímu prvku není přidružena TextBox žádná kategorie. Všechny TextBox ovládací prvky se stejnými ID sdílejí stejný seznam hodnot.
Notes	20	Všechny doplňující informace, které se mají zahrnout do kategorie formuláře.
Office	21	Umístění kategorie obchodní kanceláře.
Pager	22	Telefonní číslo pro kategorii pageru.
Search	31	Klíčové slovo nebo klíčová slova, pomocí kterých chcete prohledávat webovou stránku nebo kategorii webu.

Příklady

Následující příklad ukazuje, jak použít AutoCompleteType výčet k určení kategorie automatického dokončování ovládacího prvku TextBox .

Důležité

Tento příklad obsahuje textové pole, které přijímá vstup uživatele, což je potenciální bezpečnostní hrozba. Ve výchozím nastavení ASP.NET webové stránky ověřují, že uživatelský vstup neobsahuje skript nebo elementy HTML. Další informace najdete v tématu Přehled zneužití skriptů.


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

Poznámky

Internet Explorer 5 a novější a některé další prohlížeče podporují funkci s názvem Automatické dokončování, aby pomohla se zadáváním dat. Automatické dokončování sleduje textové pole a ukládá seznam hodnot, které uživatel zadal. Když se uživatel do textového pole vrátí jindy, zobrazí se seznam hodnot. Místo přepsání hodnoty může uživatel jednoduše vybrat hodnotu z tohoto seznamu.

Poznámka

Funkci automatického dokončování nepodporují všechny prohlížeče. Zkontrolujte kompatibilitu v prohlížeči.

K řízení chování funkce TextBox automatického dokončování ovládacího prvku použijte AutoCompleteType vlastnost . Výčet AutoCompleteType se používá k reprezentaci hodnot, které můžete použít pro AutoCompleteType vlastnost.

Ve výchozím nastavení AutoCompleteType je vlastnost ovládacího prvku nastavena TextBox na AutoCompleteType.Nonehodnotu . S tímto nastavením TextBox ovládací prvek sdílí seznam s dalšími TextBox ovládacími prvky se stejnými ID na různých stránkách. Seznam můžete také sdílet mezi ovládacími TextBox prvky založenými na kategorii místo na ID. Když nastavíte AutoCompleteType vlastnost na jednu z hodnot kategorií (například AutoCompleteType.FirstName nebo AutoCompleteType.LastName), všechny TextBox ovládací prvky se stejnou kategorií sdílejí stejný seznam. Funkci TextBox automatického dokončování ovládacího prvku můžete zakázat nastavením AutoCompleteType vlastnosti na AutoCompleteType.Disabled.

Podrobnosti o konfiguraci a povolení funkce automatického dokončování najdete v dokumentaci k prohlížeči. Pokud chcete například povolit funkci automatického dokončování v Internet Exploreru verze 5 nebo novější, v nabídce Nástroje zvolte Možnosti Internetu. Pak zvolte kartu Obsah . Pokud chcete zobrazit a upravit možnosti funkce automatického dokončování, zvolte tlačítko Automatické dokončování.

Platí pro

Sdílet prostřednictvím