TextBox.AutoCompleteType Egenskap

Definition

Namnområde:: System.Web.UI.WebControls

Sammansättning:: System.Web.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Hämtar eller anger ett värde som anger funktionen Komplettera automatiskt för TextBox kontrollen.

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

Egenskapsvärde

AutoCompleteType

Ett av AutoCompleteType uppräkningsvärdena som anger funktionen Komplettera automatiskt för TextBox kontrollen. Standardvärdet är None.

Attribut: ThemeableAttribute

Undantag

ArgumentOutOfRangeException

Det valda värdet är inte ett av uppräkningsvärdena AutoCompleteType .

Exempel

Följande kodexempel visar hur du använder AutoCompleteType uppräkningen för att ange kategorin Komplettera automatiskt för en TextBox kontroll.

Important

Det här exemplet har en textruta som accepterar användarindata, vilket är ett potentiellt säkerhetshot. Som standard kontrollerar ASP.NET webbsidor att användarindata inte innehåller skript- eller HTML-element. Mer information finns i Översikt över skriptexploateringar.


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

Kommentarer

För att hjälpa till med datainmatning stöder Microsoft Internet Explorer 5 och senare och vissa andra webbläsare en funktion som kallas Komplettera automatiskt. Komplettera automatiskt övervakar en textruta och skapar en lista med värden som användaren anger. När användaren återgår till textrutan vid ett senare tillfälle visas listan. I stället för att skriva om ett tidigare angivet värde kan användaren helt enkelt välja värdet i den här listan. Använd egenskapen AutoCompleteType för att styra beteendet för funktionen Komplettera automatiskt för en TextBox kontroll. Uppräkningen System.Web.UI.WebControls.AutoCompleteType används för att representera de värden som du kan använda för egenskapen AutoCompleteType .

Note

Alla webbläsare stöder inte funktionen Komplettera automatiskt. Kontrollera kompatibiliteten med webbläsaren.

Som standard AutoCompleteType är egenskapen för en TextBox kontroll inställd på AutoCompleteType.None. Med den TextBox här inställningen delar kontrollen listan med andra TextBox kontroller med samma ID egenskap på olika sidor. Du kan också dela en lista mellan TextBox kontroller baserat på en kategori i stället för en ID egenskap. När du anger AutoCompleteType egenskapen till ett av kategorivärdena (till exempel AutoCompleteType.FirstName, AutoCompleteType.LastNameoch så vidare) delar alla TextBox kontroller med samma kategori samma lista. Du kan inaktivera funktionen Komplettera automatiskt för en TextBox kontroll genom att ange AutoCompleteType egenskapen till AutoCompleteType.Disabled.

Mer information om hur du konfigurerar och aktiverar funktionen Komplettera automatiskt finns i webbläsarens dokumentation. Om du till exempel vill aktivera funktionen Komplettera automatiskt i Internet Explorer version 5 eller senare väljer du Internet-alternativ från menyn Tools. och välj sedan fliken Content. Klicka på knappen AutoComplete om du vill visa och ändra de olika webbläsaralternativen för funktionen Komplettera automatiskt.

Mer information om funktionen Komplettera automatiskt i Internet Explorer finns i Using AutoComplete in HTML Forms.

Den här egenskapen kan inte anges med teman eller formatmallsteman. Mer information finns i ThemeableAttribute and ASP.NET Themes and Skins.

Gäller för

Se även

AutoCompleteType

Feedback

Var den här sidan till hjälp?