AutoCompleteType Výčet

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.dll

Představuje hodnoty, které řídí chování funkce Automatické 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

Name Hodnota Description
None 0

K ovládacímu prvku není přidružena TextBox žádná kategorie. Všechny TextBox ovládací prvky se stejným ID seznamem hodnot sdílejí stejný seznam hodnot.
Disabled 1

Funkce automatického dokončování je pro ovládací prvek zakázaná TextBox .
Cellular 2

Telefonní číslo pro kategorii mobilního telefonu.
Company 3

Název obchodní kategorie.
Department 4

Oddělení v rámci obchodní kategorie.
DisplayName 5

Jméno, které se má zobrazit pro kategorii uživatele.
Email 6

Kategorie e-mailové adresy uživatele.
FirstName 7

Kategorie křestní jména.
Gender 8

Pohlaví kategorie uživatele.
HomeCity 9

Město pro kategorii domovské adresy.
HomeCountryRegion 10

Země/oblast pro kategorii domovské adresy.
HomeFax 11

Faxové číslo pro kategorii domovské adresy.
HomePhone 12

Telefonní číslo pro kategorii domácí adresy.
HomeState 13

Stav pro kategorii domovské adresy.
HomeStreetAddress 14

Ulice pro kategorii domovské adresy.
HomeZipCode 15

PSČ pro kategorii domovské adresy.
Homepage 16

Adresa URL kategorie webu.
JobTitle 17

Kategorie pracovní pozice uživatele.
LastName 18

Kategorie příjmení.
MiddleName 19

Kategorie middle name uživatele.
Notes 20

Všechny doplňující informace, které mají být zahrnuty do kategorie formuláře.
Office 21

Umístění kategorie obchodní kanceláře.
Pager 22

Telefonní číslo pro kategorii pager.
BusinessCity 23

Město pro kategorii obchodní adresy.
BusinessCountryRegion 24

Země/oblast pro kategorii obchodních adres.
BusinessFax 25

Faxové číslo pro kategorii obchodní adresy.
BusinessPhone 26

Telefonní číslo pro kategorii obchodní adresy.
BusinessState 27

Stav kategorie obchodní adresy.
BusinessStreetAddress 28

Ulice pro kategorii obchodní adresy.
BusinessUrl 29

Adresa URL kategorie obchodního webu.
BusinessZipCode 30

PSČ pro kategorii obchodních adres.
31

Klíčové slovo nebo klíčová slova, se kterými chcete hledat webovou stránku nebo kategorii webu.
Enabled 32

Pro ovládací prvek je povolená funkce automatického TextBox dokončování.

Příklady

Následující příklad ukazuje použití výčtu AutoCompleteType k určení kategorie Automatické dokončování pro TextBox ovládací prvek.

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 vstup uživatele neobsahuje skripty ani elementy HTML. Další informace naleznete 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é jiné prohlížeče podporují funkci s názvem Automatické dokončování, která vám pomůže s zadáváním dat. Automatické dokončování monitoruje textové pole a ukládá seznam hodnot, které uživatel zadal. Když se uživatel vrátí do textového pole jindy, zobrazí se seznam hodnot. Místo přetypování hodnoty může uživatel jednoduše vybrat hodnotu z tohoto seznamu.

Poznámka:

Ne všechny prohlížeče podporují funkci automatického dokončování. Zkontrolujte kompatibilitu v prohlížeči.

Chcete-li řídit 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 TextBox ovládacího prvku nastavena na AutoCompleteType.Nonehodnotu . Při tomto nastavení TextBox ovládací prvek sdílí seznam s jinými TextBox ovládacími prvky se stejnými ID na různých stránkách. Můžete také sdílet seznam mezi TextBox ovládacími prvky založenými na kategorii, nikoli na základě .ID Když vlastnost nastavíte AutoCompleteType 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é dokončování ovládacího prvku můžete zakázat nastavením AutoCompleteType vlastnosti na AutoCompleteType.Disabledhodnotu .

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 aplikaci Internet Explorer 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é dokončování, zvolte tlačítko Automatické dokončování .

Platí pro

Viz také