TextBox.AutoCompleteType Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft einen Wert ab, der das Verhalten für AutoVervollständigen des TextBox-Steuerelements angibt, oder legt diesen fest.

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

Eigenschaftswert

AutoCompleteType

Einer der AutoCompleteType-Enumerationswerte, der das AutoVervollständigungsverhalten für das TextBox-Steuerelement angibt. Der Standardwert ist None.

Attribute: ThemeableAttribute

Ausnahmen

ArgumentOutOfRangeException

Der ausgewählte Wert ist keiner der AutoCompleteType-Enumerationswerte.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die AutoCompleteType -Enumeration verwendet wird, um die AutoVervollständigen-Kategorie für ein TextBox Steuerelement anzugeben.

Wichtig

Dieses Beispiel umfasst ein Textfeld, das Benutzereingaben akzeptiert, die ein potenzielles Sicherheitsrisiko darstellen. Standardmäßig stellen ASP.NET-Webseiten sicher, dass Benutzereingaben keine Skript- oder HTML-Elemente enthalten. Weitere Informationen finden Sie unter Übersicht über Skriptangriffe.


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

Hinweise

Zur Unterstützung der Dateneingabe unterstützen Microsoft Internet Explorer 5 und höher und einige andere Browser ein Feature, das als AutoVervollständigen bezeichnet wird. AutoVervollständigen überwacht ein Textfeld und erstellt eine Liste der vom Benutzer eingegebenen Werte. Wenn der Benutzer zu einem späteren Zeitpunkt zum Textfeld zurückkehrt, wird die Liste angezeigt. Anstatt einen zuvor eingegebenen Wert neu einzugeben, kann der Benutzer einfach den Wert aus dieser Liste auswählen. Verwenden Sie die AutoCompleteType -Eigenschaft, um das Verhalten der AutoVervollständigen-Funktion für ein TextBox Steuerelement zu steuern. Die System.Web.UI.WebControls.AutoCompleteType -Enumeration wird verwendet, um die Werte darzustellen, die Sie auf die AutoCompleteType -Eigenschaft anwenden können.

Hinweis

Nicht alle Browser unterstützen die AutoVervollständigen-Funktion. Wenden Sie sich an Ihren Browser, um die Kompatibilität zu ermitteln.

Standardmäßig ist die AutoCompleteType -Eigenschaft für ein TextBox -Steuerelement auf AutoCompleteType.Nonefestgelegt. Mit dieser Einstellung teilt das TextBox Steuerelement die Liste mit anderen TextBox Steuerelementen mit derselben ID Eigenschaft auf verschiedenen Seiten. Sie können auch eine Liste zwischen TextBox Steuerelementen basierend auf einer Kategorie anstelle einer ID Eigenschaft freigeben. Wenn Sie die AutoCompleteType -Eigenschaft auf einen der Kategoriewerte (z AutoCompleteType.FirstName. B. , AutoCompleteType.LastNameusw.) festlegen, verwenden alle TextBox Steuerelemente mit derselben Kategorie dieselbe Liste. Sie können die AutoVervollständigen-Funktion für ein TextBox Steuerelement deaktivieren, indem Sie die AutoCompleteType -Eigenschaft auf AutoCompleteType.Disabledfestlegen.

Ausführliche Informationen zum Konfigurieren und Aktivieren der AutoVervollständigen-Funktion finden Sie in der Dokumentation Ihres Browsers. Wenn Sie beispielsweise das Feature AutoVervollständigen in Internet Explorer, Version 5 oder höher, aktivieren möchten, wählen Sie im Menü Extras die Option Internetoptionen und dann die Registerkarte Inhalt aus. Klicken Sie auf die Schaltfläche AutoVervollständigen, um die verschiedenen Browseroptionen für die AutoVervollständigen-Funktion anzuzeigen und zu ändern.

Weitere Informationen zum AutoVervollständigen-Feature in Internet Explorer finden Sie unter Verwenden von AutoVervollständigen in HTML-Formularen.

Diese Eigenschaft kann nicht durch Designs oder Stylesheetdesigns festgelegt werden. Weitere Informationen finden Sie unter ThemeableAttribute und ASP.NET-Designs und Skins.

Gilt für:

Weitere Informationen

AutoCompleteType