GridView.AutoGenerateEditButton Özellik

Tanım

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

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.

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 trueayarlandığı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 trueolarak 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.

Şunlara uygulanır

Ayrıca bkz.