Aracılığıyla paylaş

DetailsView.AutoGenerateInsertButton Özellik

Tanım

Ad Alanı:
System.Web.UI.WebControls
Bütünleştirilmiş Kod:
System.Web.dll

Yeni kayıt eklemek için yerleşik denetimlerin denetimde görüntülenip görüntülenmeyeceğini belirten bir DetailsView değer alır veya ayarlar.

public:
 virtual property bool AutoGenerateInsertButton { bool get(); void set(bool value); };
public virtual bool AutoGenerateInsertButton { get; set; }
member this.AutoGenerateInsertButton : bool with get, set
Public Overridable Property AutoGenerateInsertButton As Boolean

Özellik Değeri

Boolean

true yeni kayıt eklemek üzere yerleşik denetimleri görüntülemek için; aksi takdirde , false. Varsayılan değer: false.

Örnekler

Aşağıdaki kod örneği, denetime yeni bir kayıt DetailsView eklemek üzere yerleşik denetimleri görüntülemek için özelliğinin nasıl kullanılacağını AutoGenerateInsertButton gösterir.


<%@ 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>DetailsView AutoGenerateInsertButton Example</title>
</head>
<body>
    <form id="Form1" runat="server">
        
      <h3>DetailsView AutoGenerateInsertButton Example</h3>
                
        <asp:detailsview id="CustomerDetailView"
          datasourceid="DetailsViewSource"
          datakeynames="CustomerID"
          autogenerateinsertbutton="true"  
          autogeneraterows="true"
          allowpaging="true"  
          runat="server">
               
          <headerstyle backcolor="Navy"
            forecolor="White"/>
                    
        </asp:detailsview>
        
        <!-- This example uses Microsoft SQL Server and connects  -->
        <!-- to the Northwind sample database. Use an ASP.NET     -->
        <!-- expression to retrieve the connection string value   -->
        <!-- from the web.config file.                            -->
        <asp:SqlDataSource ID="DetailsViewSource" runat="server" 
          ConnectionString=
            "<%$ ConnectionStrings:NorthWindConnectionString%>"
          InsertCommand="INSERT INTO [Customers]([CustomerID], 
            [CompanyName], [Address], [City], [PostalCode], [Country]) 
            VALUES (@CustomerID, @CompanyName, @Address, @City, 
            @PostalCode, @Country)"
          SelectCommand="Select [CustomerID], [CompanyName], 
            [Address], [City], [PostalCode], [Country] 
            From [Customers]">
        </asp:SqlDataSource>
    </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>DetailsView AutoGenerateInsertButton Example</title>
</head>
<body>
    <form id="Form1" runat="server">
        
      <h3>DetailsView AutoGenerateInsertButton Example</h3>
                
        <asp:detailsview id="CustomerDetailView"
          datasourceid="DetailsViewSource"
          datakeynames="CustomerID"
          autogenerateinsertbutton="true"  
          autogeneraterows="true"
          allowpaging="true"  
          runat="server">
               
          <headerstyle backcolor="Navy"
            forecolor="White"/>
                    
        </asp:detailsview>
        
        <!-- This example uses Microsoft SQL Server and connects  -->
        <!-- to the Northwind sample database. Use an ASP.NET     -->
        <!-- expression to retrieve the connection string value   -->
        <!-- from the web.config file.                            -->
        <asp:SqlDataSource ID="DetailsViewSource" runat="server" 
          ConnectionString=
            "<%$ ConnectionStrings:NorthWindConnectionString%>"
          InsertCommand="INSERT INTO [Customers]([CustomerID], 
            [CompanyName], [Address], [City], [PostalCode], [Country]) 
            VALUES (@CustomerID, @CompanyName, @Address, @City, 
            @PostalCode, @Country)"
          SelectCommand="Select [CustomerID], [CompanyName], 
            [Address], [City], [PostalCode], [Country] 
            From [Customers]">
        </asp:SqlDataSource>
    </form>
  </body>
</html>

Açıklamalar

Eklemeyi destekleyen bir veri kaynağı denetimi bir DetailsView denetime bağlı olduğunda, DetailsView denetim veri kaynağı denetiminin özelliklerinden yararlanabilir ve otomatik ekleme işlevselliği sağlayabilir.

Uyarı

Veri kaynağı denetiminin veri eklemesi için, özelliği SqlDataSource.InsertCommand bir insert sorgu deyimiyle ayarlanmalıdır.

AutoGenerateInsertButton özelliği olarak trueCommandField ayarlandığında, denetimde DetailsView otomatik olarak Yeni düğmesini içeren bir satır alanı görüntülenir. Yeni düğmesine tıkladığınızda bu DetailsView denetim ekleme moduna geçer. Ekleme modundayken, denetimdeki salt okunur olmayan her ilişkili alan, alanın veri türü için bir denetim gibi TextBox uygun giriş denetimini görüntüler. Bu, kullanıcının yeni kayıt için alanın değerini girmesini sağlar.

Tıklandığında, Yeni düğmesi de Ekle düğmesi ve İptal düğmesiyle değiştirilir. Ekle düğmesine tıklanması yeni kaydı veri kaynağına ekler ve denetimi özelliği tarafından DefaultMode belirtilen moda döndürür. İptal düğmesine tıklanması, ekleme işlemini bırakır ve denetimi varsayılan moda döndürür.

Uyarı

Ekleme moduna program aracılığıyla satır koymak için yöntemini kullanın ChangeMode .

özelliğini kullanarak ekleme modunda olan bir kaydın InsertRowStyle görünümünü denetleyebilirsiniz. Yaygın ayarlar genellikle özel bir arka plan rengi, ön plan rengi ve yazı tipi özellikleri içerir.

Denetim, DetailsView yeni bir kayıt eklendiğinde özel bir eylem gerçekleştirmek için kullanabileceğiniz çeşitli olaylar sağlar. Aşağıdaki tabloda kullanılabilir olaylar listelenir.

Etkinlik Açıklama
ItemInserted Ekle düğmesine tıklandığında, ancak denetim kaydı ekledikten sonra DetailsView gerçekleşir. Bu olay genellikle ekleme işleminin sonuçlarını denetlemek için kullanılır.
ItemInserting Ekle düğmesine tıklandığında, ancak denetim kaydı eklemeden önce DetailsView gerçekleşir. Bu olay genellikle ekleme işlemini iptal etmek için kullanılır.
ModeChanged Denetim modlarını değiştirdikten sonra DetailsView gerçekleşir.
ModeChanging Denetim modlarını değiştirmeden önce DetailsView gerçekleşir. Bu olay genellikle mod değişikliğini iptal etmek için kullanılır.

değeri AutoGenerateInsertButton görünüm durumunda depolanır.

Şunlara uygulanır

Ayrıca bkz.