AutoCompleteType 列舉

參考

定義

命名空間:: System.Web.UI.WebControls

組件:: System.Web.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

表示可以控制 TextBox 控制項中 [自動完成] 功能行為的值。

public enum class AutoCompleteType

public enum AutoCompleteType

type AutoCompleteType =

Public Enum AutoCompleteType

繼承: Object

ValueType

Enum
AutoCompleteType

欄位

BusinessCity	23	公司地址的城市分類。
BusinessCountryRegion	24	公司地址的國家/地區分類。
BusinessFax	25	公司地址的傳真號碼分類。
BusinessPhone	26	公司地址的電話號碼分類。
BusinessState	27	公司地址的縣市分類。
BusinessStreetAddress	28	公司地址的街道分類。
BusinessUrl	29	公司網站的 URL 分類。
BusinessZipCode	30	公司地址的郵遞區號分類。
Cellular	2	行動電話的電話號碼分類。
Company	3	公司名稱分類。
Department	4	公司部門分類。
Disabled	1	TextBox 控制項已停用 [自動完成] 功能。
DisplayName	5	要顯示的使用者名稱分類。
Email	6	使用者的電子郵件地址分類。
Enabled	32	TextBox 控制項已啟用 [自動完成] 功能。
FirstName	7	第一個名稱分類。
Gender	8	使用者的性別分類。
HomeCity	9	住家地址的城市分類。
HomeCountryRegion	10	住家地址的國家/地區分類。
HomeFax	11	住家地址的傳真號碼分類。
Homepage	16	網站的 URL 分類。
HomePhone	12	住家地址的電話號碼分類。
HomeState	13	住家地址的縣市分類。
HomeStreetAddress	14	住家地址的街道分類。
HomeZipCode	15	住家地址的郵遞區號分類。
JobTitle	17	使用者的職稱分類。
LastName	18	最後一個名稱分類。
MiddleName	19	使用者的中間名分類。
None	0	TextBox 控制項沒有相關聯的分類。具有相同 TextBox 的所有 ID 控制項都會共用相同的值清單。
Notes	20	要加入表單的補充資訊分類。
Office	21	辦公室的位置分類。
Pager	22	呼叫器的電話號碼分類。
Search	31	用來搜尋 Web 網頁或網站的關鍵字分類。

範例

下列範例示範如何使用 AutoCompleteType 列舉來指定控件的 TextBox AutoComplete 類別。

重要

這個範例有一個可接受使用者輸入的文字方塊，這可能會造成安全性威脅。根據預設，ASP.NET Web 網頁會驗證使用者輸入未包含指令碼或 HTML 項目。如需詳細資訊，請參閱 Script Exploits Overview (指令碼攻擊概觀)。


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

備註

為了協助數據輸入，Internet Explorer 5 和更新版本和一些其他瀏覽器支援名為 AutoComplete 的功能。 AutoComplete 會監視文字框，並儲存使用者輸入的值清單。當使用者在另一次返回文本框時，就會顯示值清單。用戶可以直接從此清單中選取值，而不是重新系結值。

注意

並非所有瀏覽器都支援 AutoComplete 功能。請洽詢瀏覽器以判斷相容性。

若要控制控件的 AutoComplete 功能 TextBox 行為，請使用 AutoCompleteType 屬性。列舉 AutoCompleteType 是用來表示您可以套用至 AutoCompleteType 屬性的值。

根據預設， AutoCompleteType 控制項的 TextBox 屬性會設定為 AutoCompleteType.None。透過此設定， TextBox 控件會將清單與其他 TextBox 不同頁面的控件共用 ID 。您也可以根據類別，而不是根據 ID，在控件之間TextBox共享清單。當您將 AutoCompleteType 屬性設定為其中一個類別值 (例如 AutoCompleteType.FirstName 或 AutoCompleteType.LastName) 時，具有相同類別的所有 TextBox 控件都會共用相同的清單。您可以將屬性設定AutoCompleteType為 AutoCompleteType.Disabled，以停用控件的 TextBox AutoComplete 功能。

如需設定及啟用自動完成功能的詳細資訊，請參閱瀏覽器檔。例如，若要在 Internet Explorer 第 5 版或更新版本中啟用自動完成功能，請從 [ 工具 ] 功能表選擇 [ 因特網選項]。然後選擇 [ 內容] 索引標籤 。選擇 [自動完成 ] 按鈕，以檢視和修改自動完成功能的選項。

適用於

共用方式為

AutoCompleteType 列舉

定義

欄位

範例

備註

適用於

另請參閱

其他資源