GridViewUpdatedEventArgs Sınıf
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
RowUpdated olayı için veriler sağlar.
public ref class GridViewUpdatedEventArgs : EventArgspublic class GridViewUpdatedEventArgs : EventArgstype GridViewUpdatedEventArgs = class
inherit EventArgsPublic Class GridViewUpdatedEventArgs
Inherits EventArgs- Devralma
Örnekler
Aşağıdaki örnekte, bir güncelleştirme işlemi sırasında özel durumun oluşup oluşmadığının nasıl belirleneceği gösterilmektedir.
<%@ 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_RowUpdated(Object sender, GridViewUpdatedEventArgs e)
{
// Use the Exception property to determine whether an exception
// occurred during the update operation.
if (e.Exception == null)
{
// Sometimes an error might occur that does not raise an
// exception, but prevents the update operation from
// completing. Use the AffectedRows property to determine
// whether the record was actually updated.
if (e.AffectedRows == 1)
{
// Use the Keys property to get the value of the key field.
String keyFieldValue = e.Keys["CustomerID"].ToString();
// Display a confirmation message.
Message.Text = "Record " + keyFieldValue +
" updated successfully. ";
// Display the new and original values.
DisplayValues((OrderedDictionary)e.NewValues, (OrderedDictionary)e.OldValues);
}
else
{
// Display an error message.
Message.Text = "An error occurred during the update operation.";
// When an error occurs, keep the GridView
// control in edit mode.
e.KeepInEditMode = true;
}
}
else
{
// Insert the code to handle the exception.
Message.Text = e.Exception.Message;
// Use the ExceptionHandled property to indicate that the
// exception is already handled.
e.ExceptionHandled = true;
e.KeepInEditMode = true;
}
}
void DisplayValues(OrderedDictionary newValues, OrderedDictionary oldValues)
{
Message.Text += "<br/></br>";
// Iterate through the new and old values. Display the
// values on the page.
for (int i = 0; i < oldValues.Count; i++)
{
Message.Text += "Old Value=" + oldValues[i].ToString() +
", New Value=" + newValues[i].ToString() + "<br/>";
}
Message.Text += "</br>";
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>GridViewUpdatedEventArgs Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>GridViewUpdatedEventArgs Example</h3>
<!-- 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"
datasourceid="CustomersSqlDataSource"
autogeneratecolumns="true"
autogenerateeditbutton="true"
allowpaging="true"
datakeynames="CustomerID"
onrowupdated="CustomersGridView_RowUpdated"
runat="server">
</asp:gridview>
<br/>
<asp:label id="Message"
forecolor="Red"
runat="server"/>
<!-- 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)"
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_RowUpdated(sender As Object, e As GridViewUpdatedEventArgs)
' Use the Exception property to determine whether an exception
' occurred during the update operation.
If e.Exception Is Nothing Then
' Sometimes an error might occur that does not raise an
' exception, but prevents the update operation from
' completing. Use the AffectedRows property to determine
' whether the record was actually updated.
If e.AffectedRows = 1 Then
' Use the Keys property to get the value of the key field.
Dim keyFieldValue As String = e.Keys("CustomerID").ToString()
' Display a confirmation message.
Message.Text = "Record " & keyFieldValue & _
" updated successfully. "
' Display the new and original values.
DisplayValues(CType(e.NewValues, OrderedDictionary), CType(e.OldValues, OrderedDictionary))
Else
' Display an error message.
Message.Text = "An error occurred during the update operation."
' When an error occurs, keep the GridView
' control in edit mode.
e.KeepInEditMode = True
End If
Else
' Insert the code to handle the exception.
Message.Text = e.Exception.Message
' Use the ExceptionHandled property to indicate that the
' exception is already handled.
e.ExceptionHandled = True
e.KeepInEditMode = True
End If
End Sub
Sub DisplayValues(ByVal newValues As OrderedDictionary, ByVal oldValues As OrderedDictionary)
Message.Text &= "<br/></br>"
' Iterate through the new and old values. Display the
' values on the page.
Dim i As Integer
For i = 0 To oldValues.Count - 1
Message.Text &= "Old Value=" & oldValues(i).ToString() & _
", New Value=" & newValues(i).ToString() & "<br/>"
Next
Message.Text &= "</br>"
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>GridViewUpdatedEventArgs Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>GridViewUpdatedEventArgs Example</h3>
<!-- 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"
datasourceid="CustomersSqlDataSource"
autogeneratecolumns="true"
autogenerateeditbutton="true"
allowpaging="true"
datakeynames="CustomerID"
onrowupdated="CustomersGridView_RowUpdated"
runat="server">
</asp:gridview>
<br/>
<asp:label id="Message"
forecolor="Red"
runat="server"/>
<!-- 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)"
connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
runat="server">
</asp:sqldatasource>
</form>
</body>
</html>
Açıklamalar
Denetim, GridView denetimdeki RowUpdated bir Güncelleştir düğmesine tıklandığında, ancak denetim kaydı güncelleştirdikten sonra GridView olayı tetikler. (Güncelleştir düğmesi, özelliği "Güncelleştir" olarak ayarlanmış bir düğme denetimidir CommandName .) Bu olay gerçekleştiğinde bir güncelleştirme işleminin sonuçlarını denetleme gibi özel bir yordam gerçekleştirebilirsiniz.
GridViewUpdatedEventArgs Bir nesne olay işleyicisine geçirilir. Bu, etkilenen kayıt sayısını ve oluşmuş olabilecek özel durumları belirlemenizi sağlar. Güncelleştirme işleminden etkilenen kayıtların sayısını belirlemek için özelliğini kullanın AffectedRows . Herhangi bir özel durumun oluşup oluşmadığını belirlemek için özelliğini kullanın Exception . Özelliğini ayarlayarak özel durumun olay işleyicisinde işlenip işlenmediğini ExceptionHandled de belirtebilirsiniz.
Güncelleştirilmiş kaydın anahtar alanı değerlerine erişmek için özelliğini kullanın Keys . özelliğini kullanarak özgün anahtar olmayan alan değerlerine OldValues erişebilirsiniz. Özellikleri kullanarak güncelleştirilmiş anahtar olmayan alan değerlerine NewValues erişebilirsiniz.
Varsayılan olarak, denetim bir güncelleştirme işleminden GridView sonra salt okunur moda döner. Güncelleştirme işlemi sırasında oluşan bir özel durumu işlediğinizde, özelliğini trueolarak ayarlayarak KeepInEditMode denetimi düzenleme modunda tutabilirsinizGridView.
Olayları işleme hakkında daha fazla bilgi için bkz. Olayları İşleme ve Oluşturma.
Sınıfının bir örneğinin ilk özellik değerlerinin GridViewUpdatedEventArgs listesi için oluşturucuya GridViewUpdatedEventArgs bakın.
Oluşturucular
| GridViewUpdatedEventArgs(Int32, Exception) |
GridViewUpdatedEventArgs sınıfının yeni bir örneğini başlatır. |
Özellikler
| AffectedRows |
Güncelleştirme işleminden etkilenen satır sayısını alır. |
| Exception |
Güncelleştirme işlemi sırasında oluşturulan özel durumu (varsa) alır. |
| ExceptionHandled |
Güncelleştirme işlemi sırasında oluşturulan bir özel durumun olay işleyicisinde işlenip işlenmediğini belirten bir değer alır veya ayarlar. |
| KeepInEditMode |
Güncelleştirme işleminden sonra denetimin GridView düzenleme modunda kalıp kalmayacağını belirten bir değer alır veya ayarlar. |
| Keys |
Güncelleştirilmiş kayıt için anahtar alanı adı/değer çiftlerini içeren bir sözlük alır. |
| NewValues |
Güncelleştirilmiş kayıt için yeni alan adı/değer çiftlerini içeren bir sözlük alır. |
| OldValues |
Güncelleştirilmiş kayıt için özgün alan adı/değer çiftlerini içeren bir sözlük alır. |
Yöntemler
| Equals(Object) |
Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object) |
| GetHashCode() |
Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object) |
| GetType() |
Type Geçerli örneğini alır. (Devralındığı yer: Object) |
| MemberwiseClone() |
Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object) |
| ToString() |
Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object) |
