GridView.AutoGenerateEditButton Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI.WebControls
Zestaw:
System.Web.dll

Pobiera lub ustawia wartość wskazującą, czy kolumna CommandField pola z przyciskiem Edytuj dla każdego wiersza danych jest automatycznie dodawana do kontrolki GridView .

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

Wartość właściwości

Boolean

true aby automatycznie dodać kolumnę CommandField pola z przyciskiem Edytuj dla każdego wiersza danych; falsew przeciwnym razie . Wartość domyślna to false.

Przykłady

W poniższym przykładzie pokazano, jak za pomocą AutoGenerateEditButton właściwości włączyć funkcję automatycznego edytowania kontrolki 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>

Uwagi

Gdy kontrolka źródła danych, która obsługuje aktualizowanie, jest powiązana z kontrolką GridView , GridView kontrolka może korzystać z możliwości kontroli źródła danych i zapewnić funkcję automatycznego aktualizowania.

Uwaga

Aby kontrolka źródła danych aktualizowała dane, musi być skonfigurowana do aktualizowania danych. Aby skonfigurować kontrolę źródła danych w celu aktualizowania rekordów, zapoznaj się z dokumentacją dotyczącą określonej kontroli źródła danych.

AutoGenerateEditButton Gdy właściwość jest ustawiona na truewartość , kolumna (reprezentowana przez CommandField obiekt) z przyciskiem Edytuj dla każdego wiersza danych jest automatycznie dodawana do kontrolkiGridView. Kliknięcie przycisku Edytuj dla wiersza powoduje przełączenie tego wiersza w tryb edycji. Gdy wiersz jest w trybie edycji, każde pole kolumny w wierszu, które nie jest tylko do odczytu, wyświetla odpowiednią kontrolkę wejściową, taką jak kontrolka TextBox , dla typu danych pola. Dzięki temu użytkownik może zmodyfikować wartość pola.

Po kliknięciu przycisk Edytuj jest również zastępowany przyciskiem Aktualizuj i przyciskiem Anuluj. Kliknięcie przycisku Aktualizuj powoduje zaktualizowanie wiersza w źródle danych z wszelkimi zmianami wartości i zwrócenie wiersza w trybie wyświetlania. Kliknięcie przycisku Anuluj powoduje porzucenie wszystkich zmian wartości i zwrócenie wiersza do trybu wyświetlania.

Uwaga

Możesz programowo umieścić wiersz w trybie edycji, ustawiając EditIndex właściwość za pomocą indeksu wiersza. Aby programowo zamknąć tryb edycji, ustaw EditIndex właściwość na -1.

W przypadku korzystania z wbudowanej funkcji aktualizowania należy ustawić DataKeyNames właściwość z rozdzielaną przecinkami listą nazw pól, aby zidentyfikować pole klucza podstawowego lub pola źródła danych. W przeciwnym razie wbudowana funkcja aktualizacji nie będzie mogła zaktualizować poprawnego rekordu. W przypadku używania automatycznie generowanych kolumn pól (przez ustawienie AutoGenerateColumns właściwości na true), kontrolka GridView automatycznie zapewnia, że automatycznie generowane kolumny pól odpowiadające polu lub pola określone we DataKeyNames właściwości są tylko do odczytu.

Wygląd wiersza, który jest w trybie edycji, można kontrolować przy użyciu EditRowStyle właściwości . Typowe ustawienia zwykle obejmują niestandardowy kolor tła, kolor pierwszego planu i właściwości czcionki.

Kontrolka GridView udostępnia kilka zdarzeń, których można użyć do wykonania akcji niestandardowej po zaktualizowaniu wiersza. W poniższej tabeli wymieniono dostępne zdarzenia.

Zdarzenie Opis
RowCancelingEdit Występuje po kliknięciu przycisku Anuluj wiersza, ale zanim GridView kontrolka anuluje tryb edycji. To zdarzenie jest często używane do zatrzymywania operacji anulowania.
RowEditing Występuje po kliknięciu przycisku Edytuj wiersza, ale zanim GridView kontrolka przejdzie w tryb edycji. To zdarzenie jest często używane do anulowania operacji edycji.
RowUpdated Występuje po kliknięciu przycisku Aktualizuj wiersza, ale po zaktualizowaniu GridView wiersza kontrolki. To zdarzenie jest często używane do sprawdzania wyników operacji aktualizacji.
RowUpdating Występuje po kliknięciu przycisku Aktualizuj wiersza, ale zanim GridView kontrolka zaktualizuje wiersz. To zdarzenie jest często używane do anulowania operacji aktualizowania.

Dotyczy

Zobacz też