Share via

DetailsView.AutoGenerateInsertButton Özellik

  • Başvuru

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 bir denetimde DetailsView görüntülenip görüntülenmeyeceğini belirten bir 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, denetimine AutoGenerateInsertButton yeni DetailsView kayıt eklemek için yerleşik denetimleri görüntülemek için özelliğinin nasıl kullanılacağını 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.

Not

Veri kaynağı denetiminin veri ekleyebilmesi için özelliğinin SqlDataSource.InsertCommand insert sorgu deyimiyle ayarlanması gerekir.

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ıklanması bu DetailsView denetimi ekleme moduna geçirir. 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.

Not

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

özelliğini kullanarak InsertRowStyle ekleme modundaki bir kaydın görünümünü denetleyebilirsiniz. Genel ayarlar genellikle özel bir arka plan rengi, ön plan rengi ve yazı tipi özelliklerini 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.

Olay 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.