TextBox.AutoCompleteType Özellik

Başvuru

Tanım

Ad Alanı:: System.Web.UI.WebControls

Bütünleştirilmiş Kod:: System.Web.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Denetimin Otomatik Tamamlama davranışını TextBox gösteren bir değer alır veya ayarlar.

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

Özellik Değeri

AutoCompleteType

Denetim için AutoCompleteType TextBox Otomatik Tamamlama davranışını gösteren numaralandırma değerlerinden biri. None varsayılan değerdir.

Öznitelikler: ThemeableAttribute

Özel durumlar

ArgumentOutOfRangeException

Seçilen değer numaralandırma değerlerinden AutoCompleteType biri değil.

Örnekler

Aşağıdaki kod örneği, bir TextBox denetim için Otomatik Tamamlama kategorisini belirtmek üzere numaralandırmanın nasıl kullanılacağını AutoCompleteType gösterir.

Önemli

Bu örnekte, olası bir güvenlik tehdidi olan kullanıcı girişini kabul eden bir metin kutusu vardır. Varsayılan olarak, ASP.NET Web sayfaları kullanıcı girişinin betik veya HTML öğeleri içermediğini doğrular. Daha fazla bilgi için bkz. Betik Açıklarına Genel Bakış.


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

Açıklamalar

Veri girişine yardımcı olmak için Internet Explorer 5 ve üzerini Microsoft ve diğer bazı tarayıcılar Otomatik Tamamlama olarak adlandırılan bir özelliği destekler. Otomatik Tamamlama bir metin kutusunu izler ve kullanıcı tarafından girilen değerlerin listesini oluşturur. Kullanıcı daha sonra metin kutusuna döndüğünde liste görüntülenir. Kullanıcı, daha önce girilen bir değeri yeniden oluşturmak yerine bu listeden değeri seçebilir. AutoCompleteType Bir denetim için Otomatik Tamamlama özelliğinin davranışını denetlemek için TextBox özelliğini kullanın. System.Web.UI.WebControls.AutoCompleteType Numaralandırma özelliğine uygulayabileceğiniz değerleri temsil etmek için AutoCompleteType kullanılır.

Not

Tüm tarayıcılar Otomatik Tamamlama özelliğini desteklemez. Uyumluluğu belirlemek için tarayıcınıza danışın.

Varsayılan olarak, bir TextBox denetimin AutoCompleteType özelliği olarak AutoCompleteType.Noneayarlanır. Bu ayar ile TextBox denetim, listeyi farklı sayfalarda aynı ID özelliğe sahip diğer TextBox denetimlerle paylaşır. Ayrıca, bir özellik yerine kategoriye dayalı denetimler arasında TextBox liste ID paylaşabilirsiniz. AutoCompleteType özelliğini kategori değerlerinden birine ayarladığınızda (örneğinAutoCompleteType.FirstName, , AutoCompleteType.LastNamevb.), aynı kategoriye sahip tüm TextBox denetimler aynı listeyi paylaşır. özelliğini olarak ayarlayarak AutoCompleteType bir TextBox denetim için Otomatik Tamamlama özelliğini AutoCompleteType.Disableddevre dışı bırakabilirsiniz.

Otomatik Tamamlama özelliğini yapılandırma ve etkinleştirme hakkında ayrıntılı bilgi için tarayıcı belgelerinize bakın. Örneğin, Internet Explorer sürüm 5 veya sonraki sürümlerinde Otomatik Tamamlama özelliğini etkinleştirmek için Araçlarmenüsünden İnternet Seçenekleri'ni ve ardından İçerik sekmesini seçin. Otomatik Tamamlama özelliğinin çeşitli tarayıcı seçeneklerini görüntülemek ve değiştirmek için Otomatik Tamamla düğmesine tıklayın.

Internet Explorer'daki Otomatik Tamamlama özelliği hakkında daha fazla bilgi için bkz. HTML Formlarında Otomatik Tamamlama'yı Kullanma.

Bu özellik temalar veya stil sayfası temaları tarafından ayarlanamaz. Daha fazla bilgi için bkz ThemeableAttribute . temalar ve dış görünümler ASP.NET.

Şunlara uygulanır

Ayrıca bkz.

AutoCompleteType