CommandField.ShowInsertButton Özellik
Tanım
Ö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.
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
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.Link
olarak 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.