Aracılığıyla paylaş

GridView.AutoGenerateEditButton Özellik

Tanım

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

Her veri satırı için Düzenle düğmesine sahip alan CommandField sütunlarının 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

Boolean

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.

Uyarı

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ğı denetiminin belgelerine bakın.

AutoGenerateEditButton özelliği olarak ayarlandığında, denetime trueher veri satırı için Düzenle düğmesi olan bir sütun (nesneyle CommandField temsil edilir) otomatik olarak eklenirGridView. 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 de bir Güncelleştir düğmesi ve İptal düğmesiyle değiştirilir. Güncelleştir düğmesine tıklanması veri kaynağındaki satırı tüm 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.

Uyarı

Ö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, birincil anahtar alanını veya veri kaynağının alanlarını tanımlamak için özelliği virgülle ayrılmış alan adları listesiyle ayarlamanız DataKeyNames 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 trueolarak ayarlayarakAutoGenerateColumns), GridView denetim otomatik olarak özellikte 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 düzenleme modunda olan bir satırın EditRowStyle 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, 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.

Etkinlik Açıklama
RowCancelingEdit Bir satırın İptal düğmesine tıklandığında, ancak denetim düzenleme modundan GridView çıkmadan ö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.

Şunlara uygulanır

Ayrıca bkz.