GridView.AutoGenerateEditButton Ö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.
Her veri satırı için Düzenle düğmesi olan bir CommandField alan sütununu otomatik olarak denetime eklenip eklenmeyeceğini belirten bir GridView değer alır veya ayarlar.
public:
virtual property bool AutoGenerateEditButton { bool get(); void set(bool value); };
public virtual bool AutoGenerateEditButton { get; set; }
member this.AutoGenerateEditButton : bool with get, set
Public Overridable Property AutoGenerateEditButton As Boolean
Özellik Değeri
true
her veri satırı için Düzenle düğmesi olan bir CommandField alan sütununu otomatik olarak eklemek için; aksi takdirde , false
. Varsayılan değer: false
.
Örnekler
Aşağıdaki örnekte, denetimin AutoGenerateEditButton otomatik düzenleme özelliğini etkinleştirmek için özelliğinin nasıl kullanılacağı gösterilmektedir GridView .
<asp:LinqDataSource ID="LinqDataSource1" runat="server"
ContextTypeName="AdventureWorksLTDataClassesDataContext"
EnableDelete="True" EnableInsert="True" EnableUpdate="True"
TableName="SalesOrderDetails">
</asp:LinqDataSource>
<asp:GridView ID="GridView1" runat="server"
AutoGenerateColumns="False"
DataKeyNames="SalesOrderID,SalesOrderDetailID"
DataSourceID="LinqDataSource1">
<Columns>
<asp:CommandField ShowDeleteButton="True"
ShowEditButton="True" />
<asp:BoundField DataField="SalesOrderID"
HeaderText="SalesOrderID" ReadOnly="True"
SortExpression="SalesOrderID" />
<asp:BoundField DataField="SalesOrderDetailID"
HeaderText="SalesOrderDetailID" InsertVisible="False"
ReadOnly="True" SortExpression="SalesOrderDetailID" />
<asp:BoundField DataField="OrderQty"
HeaderText="OrderQty" SortExpression="OrderQty" />
<asp:BoundField DataField="ProductID"
HeaderText="ProductID" SortExpression="ProductID" />
<asp:BoundField DataField="UnitPrice"
HeaderText="UnitPrice" SortExpression="UnitPrice" />
<asp:BoundField DataField="ModifiedDate"
HeaderText="ModifiedDate" SortExpression="ModifiedDate" />
</Columns>
</asp:GridView>
<asp:LinqDataSource ID="LinqDataSource1" runat="server"
ContextTypeName="AdventureWorksLTDataClassesDataContext"
EnableDelete="True" EnableInsert="True" EnableUpdate="True"
TableName="SalesOrderDetails">
</asp:LinqDataSource>
<asp:GridView ID="GridView1" runat="server"
AutoGenerateColumns="False"
DataKeyNames="SalesOrderID,SalesOrderDetailID"
DataSourceID="LinqDataSource1">
<Columns>
<asp:CommandField ShowDeleteButton="True"
ShowEditButton="True" />
<asp:BoundField DataField="SalesOrderID"
HeaderText="SalesOrderID" ReadOnly="True"
SortExpression="SalesOrderID" />
<asp:BoundField DataField="SalesOrderDetailID"
HeaderText="SalesOrderDetailID" InsertVisible="False"
ReadOnly="True" SortExpression="SalesOrderDetailID" />
<asp:BoundField DataField="OrderQty"
HeaderText="OrderQty" SortExpression="OrderQty" />
<asp:BoundField DataField="ProductID"
HeaderText="ProductID" SortExpression="ProductID" />
<asp:BoundField DataField="UnitPrice"
HeaderText="UnitPrice" SortExpression="UnitPrice" />
<asp:BoundField DataField="ModifiedDate"
HeaderText="ModifiedDate" SortExpression="ModifiedDate" />
</Columns>
</asp:GridView>
Açıklamalar
Güncelleştirmeyi destekleyen bir veri kaynağı denetimi bir GridView denetime bağlı olduğunda, GridView denetim veri kaynağı denetiminin özelliklerinden yararlanabilir ve otomatik güncelleştirme işlevselliği sağlayabilir.
Not
Veri kaynağı denetiminin verileri güncelleştirmesi için verilerin güncelleştirilecek şekilde yapılandırılması gerekir. Kayıtları güncelleştirmek üzere bir veri kaynağı denetimi yapılandırmak için belirli veri kaynağı denetimi belgelerine bakın.
AutoGenerateEditButton özelliği olarak true
ayarlandığında, her veri satırı için Düzenle düğmesine sahip bir sütun (nesneyle CommandField gösterilir) otomatik olarak denetime GridView eklenir. Bir satır için Düzenle düğmesine tıklanması, bu satırı düzenleme moduna geçirir. Bir satır düzenleme modundayken, satırdaki salt okunur olmayan her sütun alanı, alanın veri türü için denetim gibi TextBox uygun giriş denetimini görüntüler. Bu, kullanıcının alanın değerini değiştirmesine olanak tanır.
Tıklandığında, Düzenle düğmesi bir Güncelleştir düğmesi ve İptal düğmesiyle de değiştirilir. Güncelleştir düğmesine tıklanması veri kaynağındaki satırı değer değişiklikleriyle güncelleştirir ve satırı görüntüleme moduna döndürür. İptal düğmesine tıklanması değer değişikliklerini bırakır ve satırı görüntüleme moduna döndürür.
Not
Özelliği satırın diziniyle ayarlayarak EditIndex program aracılığıyla bir satırı düzenleme moduna alabilirsiniz. Program aracılığıyla düzenleme modundan EditIndex çıkmak için özelliğini -1 olarak ayarlayın.
Yerleşik güncelleştirme işlevini kullanırken, veri kaynağının DataKeyNames birincil anahtar alanını veya alanlarını tanımlamak için özelliği virgülle ayrılmış alan adları listesiyle ayarlamanız gerekir; aksi takdirde, yerleşik güncelleştirme işlevi doğru kaydı güncelleştiremez. Otomatik olarak oluşturulan alan sütunlarını kullanırken (özelliği true
olarak ayarlayarakAutoGenerateColumns), GridView denetim otomatik olarak özelliğinde DataKeyNames belirtilen alan veya alanlara karşılık gelen otomatik olarak oluşturulan alan sütunlarının salt okunur olmasını sağlar.
özelliğini kullanarak EditRowStyle düzenleme modundaki bir satırı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, GridView bir satır güncelleştirildiğinde özel eylem gerçekleştirmek için kullanabileceğiniz çeşitli olaylar sağlar. Aşağıdaki tabloda kullanılabilir olaylar listelenir.
Olay | Description |
---|---|
RowCancelingEdit | Bir satırın İptal düğmesine tıklandığında, ancak denetim düzenleme modundan GridView iptal edilmeden önce gerçekleşir. Bu olay genellikle iptal işlemini durdurmak için kullanılır. |
RowEditing | Bir satırın Düzenle düğmesine tıklandığında, ancak denetim düzenleme moduna girmeden önce GridView gerçekleşir. Bu olay genellikle düzenleme işlemini iptal etmek için kullanılır. |
RowUpdated | Bir satırın Güncelleştir düğmesine tıklandığında, ancak denetim satırı güncelleştirdikten sonra GridView gerçekleşir. Bu olay genellikle güncelleştirme işleminin sonuçlarını denetlemek için kullanılır. |
RowUpdating | Bir satırın Güncelleştir düğmesine tıklandığında, ancak denetim satırı güncelleştirmeden önce GridView gerçekleşir. Bu olay genellikle güncelleştirme işlemini iptal etmek için kullanılır. |