GridView.EditIndex Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft den Wert des Indexes für die zu bearbeitende Zeile ab oder legt ihn fest.
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 IntegerEigenschaftswert
Der auf 0 basierende Index der zu bearbeitenden Zeile. Der Standardwert ist -1 und bedeutet, dass keine Zeile bearbeitet wird.
Ausnahmen
Der angegebene Index ist kleiner als -1.
Beispiele
Im folgenden Beispiel wird veranschaulicht, wie die EditIndex -Eigenschaft verwendet wird, um zu bestimmen, welche Zeile aktualisiert wurde, nachdem sie in einem GridView Steuerelement bearbeitet wurde. Es wird eine Meldung angezeigt, die angibt, dass das Update erfolgreich war.
<%@ 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>
Hinweise
Der Zeilenindex ist nullbasiert (die erste Zeile ist Zeile 0).
Diese Eigenschaft wird in der Regel nur in den folgenden Szenarien verwendet, die Handler für bestimmte Ereignisse umfassen:
Sie möchten, dass das GridView Steuerelement im Bearbeitungsmodus für eine bestimmte Zeile geöffnet wird, wenn die Seite zum ersten Mal angezeigt wird. Hierzu können Sie die EditIndex -Eigenschaft im Handler für das Load Ereignis der Page -Klasse oder des GridView -Steuerelements festlegen.
Sie möchten wissen, welche Zeile bearbeitet wurde, nachdem die Zeile aktualisiert wurde. Dazu können Sie den Zeilenindex aus der EditIndex Eigenschaft im RowUpdated Ereignishandler abrufen.
Sie binden das GridView Steuerelement an eine Datenquelle, indem Sie die DataSource Eigenschaft programmgesteuert festlegen. In diesem Fall müssen Sie die EditIndex Eigenschaft in den RowEditing Ereignishandlern und RowCancelingEdit festlegen.
Wenn Sie die EditIndex -Eigenschaft nach einem Postback oder in Handlern für Ereignisse festlegen, die später als das Load Ereignis ausgelöst werden, wird das Steuerelement möglicherweise nicht in den GridView Bearbeitungsmodus für die angegebene Zeile versetzt. Wenn Sie den Wert dieser Eigenschaft in anderen Ereignishandlern lesen, wird nicht garantiert, dass der Index die Zeile wiedergibt, die bearbeitet wird.
Um zu bestimmen, in welcher Zeile der Benutzer auf eine Schaltfläche oder einen Link geklickt hat, bevor das Steuerelement in den GridView Bearbeitungsmodus wechselt, können Sie den Zeilenindex aus der NewEditIndex Eigenschaft des GridViewEditEventArgs Objekts im RowEditing Ereignishandler abrufen.
Um zu verhindern, dass das Steuerelement in den GridView Bearbeitungsmodus wechselt, nachdem ein Benutzer auf eine Schaltfläche oder einen Link bearbeiten geklickt hat, legen Sie die Cancel Eigenschaft des GridViewEditEventArgs Objekts im RowEditing Ereignishandler auf true fest.
