AutoCompleteType Výčet

  • Reference

Definice

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

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.
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

Viz také