Aracılığıyla paylaş

CommandField.ShowInsertButton Özellik

  • Başvuru

Tanım

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

Alanda Yeni düğmesinin görüntülenip görüntülenmeyeceğini belirten bir CommandField değer alır veya ayarlar.

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

Özellik Değeri

Boolean

true içinde Yeni düğmesini CommandFieldgörüntülemek için ; değilse, false. Varsayılan değer: false.

Örnekler

Aşağıdaki kod örneği, kullanıcının veri kaynağına yeni kayıt eklemesine olanak tanıyan bir DetailsView denetimde Yeni düğmesini görüntülemek için özelliğinin nasıl kullanılacağını ShowInsertButton 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>CommandField Example</title>
</head>
<body>
    <form id="form1" runat="server">
      
      <h3>CommandField Example</h3>

      <asp:detailsview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneraterows="false"
        datakeynames="CustomerID"  
        allowpaging="true" 
        runat="server">
        
        <fields>
          <asp:boundfield datafield="CustomerID"
            headertext="Customer ID" />
          <asp:boundfield datafield="CompanyName"
            headertext="CompanyName"/>
          <asp:boundfield datafield="Address"
            headertext="Address"/>
          <asp:boundfield datafield="City"
            headertext="City"/>
          <asp:boundfield datafield="PostalCode"
            headertext="ZIP Code"/>
          <asp:boundfield datafield="Country"
            headertext="Country"/>
          <asp:commandfield showinsertbutton="true"
            showheader="true"
            headertext="Add Customer"/>
        </fields>
        
      </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="CustomersSqlDataSource"  
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        insertcommand="Insert Into [Customers]([CustomerID], [CompanyName], [City], [PostalCode], [Country]) Values (@CustomerID, @CompanyName, @City, @PostalCode, @Country)"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
        runat="server">
      </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>CommandField Example</title>
</head>
<body>
    <form id="form1" runat="server">
      
      <h3>CommandField Example</h3>

      <asp:detailsview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneraterows="false"
        datakeynames="CustomerID"  
        allowpaging="true" 
        runat="server">
        
        <fields>
          <asp:boundfield datafield="CustomerID"
            headertext="Customer ID" />
          <asp:boundfield datafield="CompanyName"
            headertext="CompanyName"/>
          <asp:boundfield datafield="Address"
            headertext="Address"/>
          <asp:boundfield datafield="City"
            headertext="City"/>
          <asp:boundfield datafield="PostalCode"
            headertext="ZIP Code"/>
          <asp:boundfield datafield="Country"
            headertext="Country"/>
          <asp:commandfield showinsertbutton="true"
            showheader="true"
            headertext="Add Customer"/>
        </fields>
        
      </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="CustomersSqlDataSource"  
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        insertcommand="Insert Into [Customers]([CustomerID], [CompanyName], [City], [PostalCode], [Country]) Values (@CustomerID, @CompanyName, @City, @PostalCode, @Country)"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
        runat="server">
      </asp:sqldatasource>
            
    </form>
  </body>
</html>

Açıklamalar

Bir alanda Yeni düğmesinin ShowInsertButton görüntülenip görüntülenmeyeceğini CommandField belirtmek için özelliğini kullanın. Yeni düğmesi alanda yalnızca bir kez CommandField görüntülenir ve kullanıcının veri kaynağına yeni bir kayıt eklemesine izin verir.

Not

Bu özellik yalnızca denetim gibi ekleme işlemlerini destekleyen veriye bağlı denetimler DetailsView için geçerlidir.

Kullanıcı Yeni düğmesine tıkladığında, veriye bağlı denetimde görüntülenen her alan için giriş denetimleri görüntülenir ve kullanıcının yeni kaydın değerlerini girmesini sağlar. Yeni düğmesi, Ekle düğmesi ve İptal düğmesiyle değiştirilir ve alandaki diğer tüm komut düğmeleri gizlenir CommandField . Ekle düğmesine tıklanması kaydı veri kaynağına eklerken İptal düğmesine tıklanması işlemi iptal eder.

Not

Veriye bağlı denetim bir veri kaynağı denetimiyle (denetim gibi SqlDataSource ) birlikte kullanıldığında, veriye bağlı denetim veri kaynağı denetiminin özelliklerinden yararlanabilir ve otomatik ekleme işlevselliği sağlayabilir. Diğer veri kaynakları için, veriye bağlı denetim için uygun olay sırasında ekleme işlemini gerçekleştirmek için yordamları sağlamanız gerekir.

ButtonType Bir CommandField alanın özelliği veya ButtonType.Linkolarak ayarlandığındaButtonType.Button, Yeni düğmesi için görüntülenecek metni belirtmek üzere özelliğini kullanınNewText. Alternatif olarak, önce özelliğini olarak ve ardından özelliğini ButtonType.Image ayarlayarak ButtonTypeNewImageUrl bir görüntü görüntüleyebilirsiniz.

Şunlara uygulanır

Ayrıca bkz.