GridView.EditIndex Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá nebo nastaví index řádku, který chcete upravit.
public:
virtual property int EditIndex { int get(); void set(int value); };public virtual int EditIndex { get; set; }member this.EditIndex : int with get, setPublic Overridable Property EditIndex As IntegerHodnota vlastnosti
Index řádku, který chcete upravit, je založený na nule. Výchozí hodnota je -1, což znamená, že se neupravuje žádný řádek.
Výjimky
Zadaný index je menší než -1.
Příklady
Následující příklad ukazuje, jak pomocí EditIndex vlastnosti určit, který řádek byl aktualizován po úpravě v ovládacím prvku GridView . Zobrazí se zpráva s oznámením, že aktualizace proběhla úspěšně.
<%@ Page language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
void CustomersGridView_RowCommand(Object sender, GridViewCommandEventArgs e)
{
// Clear the message label when the user enters edit mode.
if (e.CommandName == "Edit")
{
Message.Text = "";
}
}
void CustomersGridView_RowUpdated(Object sender, GridViewUpdatedEventArgs e)
{
// The update operation was successful. Retrieve the row being edited.
int index = CustomersGridView.EditIndex;
GridViewRow row = CustomersGridView.Rows[index];
// Notify the user that the update was successful.
Message.Text = "Updated record " + row.Cells[1].Text + ".";
}
void CustomersGridView_RowCancelingEdit(Object sender, GridViewCancelEditEventArgs e)
{
// The update operation was canceled. Display the appropriate message.
Message.Text = "Update operation canceled.";
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>GridView Rows Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>GridView Rows Example</h3>
<asp:label id="Message"
forecolor="Red"
runat="server"/>
<br/>
<!-- The GridView control automatically sets the columns -->
<!-- specified in the datakeynames property as read-only. -->
<!-- No input controls are rendered for these columns in -->
<!-- edit mode. -->
<asp:gridview id="CustomersGridView"
allowpaging="true"
datasourceid="CustomersSqlDataSource"
autogeneratecolumns="true"
autogenerateeditbutton="true"
datakeynames="CustomerID"
onrowcommand="CustomersGridView_RowCommand"
onrowupdated="CustomersGridView_RowUpdated"
onrowcancelingedit="CustomersGridView_RowCancelingEdit"
runat="server">
</asp:gridview>
<!-- 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]"
updatecommand="Update Customers SET CompanyName=@CompanyName, Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country WHERE (CustomerID = @CustomerID)"
deletecommand="Delete from Customers where CustomerID = @CustomerID"
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">
<script runat="server">
Sub CustomersGridView_RowCommand(ByVal sender As Object, ByVal e As GridViewCommandEventArgs)
' Clear the message label when the user enters edit mode.
If e.CommandName = "Edit" Then
Message.Text = ""
End If
End Sub
Sub CustomersGridView_RowUpdated(ByVal sender As Object, ByVal e As GridViewUpdatedEventArgs)
' The update operation was successful. Retrieve the row being edited.
Dim index As Integer = CustomersGridView.EditIndex
Dim row As GridViewRow = CustomersGridView.Rows(index)
' Notify the user that the update was successful.
Message.Text = "Updated record " & row.Cells(1).Text + "."
End Sub
Sub CustomersGridView_RowCancelingEdit(ByVal sender As Object, ByVal e As GridViewCancelEditEventArgs)
' The update operation was canceled. Display the appropriate message.
Message.Text = "Update operation canceled."
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>GridView Rows Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>GridView Rows Example</h3>
<asp:label id="Message"
forecolor="Red"
runat="server"/>
<br/>
<!-- The GridView control automatically sets the columns -->
<!-- specified in the datakeynames property as read-only. -->
<!-- No input controls are rendered for these columns in -->
<!-- edit mode. -->
<asp:gridview id="CustomersGridView"
allowpaging="true"
datasourceid="CustomersSqlDataSource"
autogeneratecolumns="true"
autogenerateeditbutton="true"
datakeynames="CustomerID"
onrowcommand="CustomersGridView_RowCommand"
onrowupdated="CustomersGridView_RowUpdated"
onrowcancelingedit="CustomersGridView_RowCancelingEdit"
runat="server">
</asp:gridview>
<!-- 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]"
updatecommand="Update Customers SET CompanyName=@CompanyName, Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country WHERE (CustomerID = @CustomerID)"
deletecommand="Delete from Customers where CustomerID = @CustomerID"
connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
runat="server">
</asp:sqldatasource>
</form>
</body>
</html>
Poznámky
Index řádků je založený na nule (první řádek je řádek nula).
Tato vlastnost se obvykle používá pouze v následujících scénářích, které zahrnují obslužné rutiny pro konkrétní události:
Chcete, aby se GridView ovládací prvek otevřel v režimu úprav pro konkrétní řádek při prvním zobrazení stránky. Chcete-li to provést, můžete nastavit EditIndex vlastnost v obslužné rutině Load pro událost Page třídy nebo GridView ovládacího prvku.
Chcete vědět, který řádek byl po aktualizaci upraven. Chcete-li to provést, můžete načíst index řádků z EditIndex vlastnosti v obslužné rutině RowUpdated události.
Vytvoříte vazbu ovládacího prvku na GridView zdroj dat nastavením DataSource vlastnosti programově. V tomto případě musíte nastavit EditIndex vlastnost v obslužných RowEditing rutinách událostí a RowCancelingEdit .
Pokud nastavíte EditIndex vlastnost po postbacku nebo v obslužných rutinách pro události, které jsou vyvolány později než Load událost, GridView ovládací prvek nemusí přejít do režimu úprav pro zadaný řádek. Pokud přečtete hodnotu této vlastnosti v jiných obslužných rutinách událostí, není zaručeno, že index bude odrážet řádek, který je upravován.
Chcete-li zjistit, ve kterém řádku uživatel kliknul na tlačítko Upravit nebo hypertextový odkaz před tím, než GridView ovládací prvek přejde do režimu úprav, můžete načíst index řádků z NewEditIndex vlastnosti objektu GridViewEditEventArgs v obslužné rutině RowEditing události.
Pokud chcete ovládacímu prvku zabránit GridView v přechodu do režimu úprav poté, co uživatel klikne na tlačítko Upravit nebo hypertextový odkaz, nastavte Cancel vlastnost objektu GridViewEditEventArgs na true v obslužné rutině RowEditing události.
