DetailsViewUpdatedEventArgs Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Menyediakan data untuk peristiwa tersebut ItemUpdated .
public ref class DetailsViewUpdatedEventArgs : EventArgspublic class DetailsViewUpdatedEventArgs : EventArgstype DetailsViewUpdatedEventArgs = class
inherit EventArgsPublic Class DetailsViewUpdatedEventArgs
Inherits EventArgs- Warisan
Contoh
Contoh kode berikut menunjukkan cara menggunakan objek yang DetailsViewUpdatedEventArgs diteruskan ke penanganan aktivitas untuk peristiwa guna ItemUpdated menentukan apakah pengecualian terjadi selama operasi pembaruan.
<%@ 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 CustomerDetailsView_ItemUpdated(Object sender,
DetailsViewUpdatedEventArgs e)
{
// Use the Exception property to determine whether an exception
// occurred during the insert operation.
if (e.Exception == null)
{
// Use the Values property to get the value entered by
// the user for the CompanyName field.
String keyFieldValue = e.Keys["CustomerID"].ToString();
// Display a confirmation message.
MessageLabel.Text = "Record " + keyFieldValue +
" updated successfully. ";
// Display the old and new values.
DisplayValues(e);
if (e.AffectedRows == 1)
{
MessageLabel.Text += e.AffectedRows.ToString() +
" record updated.";
}
else
{
MessageLabel.Text += e.AffectedRows.ToString() +
" records updated.";
}
}
else
{
// Insert the code to handle the exception.
MessageLabel.Text = e.Exception.Message;
// Use the ExceptionHandled property to indicate that the
// exception is already handled.
e.ExceptionHandled = true;
// When an exception occurs, keep the DetailsView
// control in edit mode.
e.KeepInEditMode = true;
}
}
void DisplayValues(DetailsViewUpdatedEventArgs e)
{
MessageLabel.Text += "<br/></br>";
// Iterate through the OldValue and NewValues
// properties and display the values.
for (int i = 0; i < e.OldValues.Count; i++)
{
MessageLabel.Text += "Old Value=" + e.OldValues[i].ToString() +
", New Value=" + e.NewValues[i].ToString() + "<br/>";
}
MessageLabel.Text += "</br>";
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>DetailsViewUpdatedEventArgs Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>DetailsViewUpdatedEventArgs Example</h3>
<asp:detailsview id="CustomerDetailsView"
datasourceid="DetailsViewSource"
autogeneraterows="true"
autogenerateeditbutton="true"
allowpaging="true"
datakeynames="CustomerID"
onitemupdated="CustomerDetailsView_ItemUpdated"
runat="server">
<pagersettings position="Bottom"/>
</asp:detailsview>
<br/>
<asp:label id="MessageLabel"
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="DetailsViewSource"
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"/>
</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 CustomerDetailsView_ItemUpdated(ByVal sender As Object, ByVal e As DetailsViewUpdatedEventArgs)
' Use the Exception property to determine whether an exception
' occurred during the insert operation.
If e.Exception Is Nothing Then
' Use the Values property to get the value entered by
' the user for the CompanyName field.
Dim keyFieldValue As String = e.Keys("CustomerID").ToString()
' Display a confirmation message.
MessageLabel.Text = "Record " & keyFieldValue & _
" updated successfully. "
' Display the old and new values.
DisplayValues(e)
If e.AffectedRows = 1 Then
MessageLabel.Text &= e.AffectedRows.ToString() & _
" record updated."
Else
MessageLabel.Text &= e.AffectedRows.ToString() & _
" records updated."
End If
Else
' Insert the code to handle the exception.
MessageLabel.Text = e.Exception.Message
' Use the ExceptionHandled property to indicate that the
' exception is already handled.
e.ExceptionHandled = True
' When an exception occurs, keep the DetailsView
' control in edit mode.
e.KeepInEditMode = True
End If
End Sub
Sub DisplayValues(ByVal e As DetailsViewUpdatedEventArgs)
MessageLabel.Text &= "<br/></br>"
' Iterate through the OldValue and NewValues
' properties and display the values.
Dim i As Integer
For i = 0 To e.OldValues.Count - 1
MessageLabel.Text &= "Old Value=" & e.OldValues(i).ToString() & _
", New Value=" & e.NewValues(i).ToString() & "<br/>"
Next
MessageLabel.Text &= "</br>"
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>DetailsViewUpdatedEventArgs Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>DetailsViewUpdatedEventArgs Example</h3>
<asp:detailsview id="CustomerDetailsView"
datasourceid="DetailsViewSource"
autogeneraterows="true"
autogenerateeditbutton="true"
allowpaging="true"
datakeynames="CustomerID"
onitemupdated="CustomerDetailsView_ItemUpdated"
runat="server">
<pagersettings position="Bottom"/>
</asp:detailsview>
<br/>
<asp:label id="MessageLabel"
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="DetailsViewSource"
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"/>
</form>
</body>
</html>
Keterangan
DetailsView Kontrol menaikkan ItemUpdated peristiwa saat tombol Perbarui (tombol dengan propertinya CommandName diatur ke "Perbarui") dalam kontrol diklik, tetapi setelah DetailsView kontrol memperbarui rekaman. Ini memungkinkan Anda untuk menyediakan penanganan aktivitas yang melakukan rutinitas kustom, seperti memeriksa hasil operasi pembaruan, setiap kali peristiwa ini terjadi.
Objek DetailsViewUpdatedEventArgs diteruskan ke penanganan aktivitas, yang memungkinkan Anda menentukan jumlah rekaman yang terpengaruh dan pengecualian apa pun yang mungkin terjadi. Untuk menentukan jumlah rekaman yang terpengaruh oleh operasi pembaruan, gunakan AffectedRows properti . Exception Gunakan properti untuk menentukan apakah ada pengecualian yang terjadi. Anda juga dapat menunjukkan apakah pengecualian ditangani di penanganan aktivitas dengan mengatur ExceptionHandled properti . Jika Anda perlu mengakses nilai bidang kunci untuk rekaman yang diperbarui, gunakan Keys properti . Nilai bidang non-kunci asli dan yang diperbarui dapat diakses menggunakan OldValues properti dan NewValues , masing-masing.
Secara default, DetailsView kontrol kembali ke mode yang ditentukan oleh DefaultMode properti setelah operasi pembaruan. Untuk mempertahankan DetailsView kontrol dalam mode edit, atur properti ke KeepInEditModetrue.
Untuk informasi selengkapnya tentang cara menangani peristiwa, lihat Menangani dan Menaikkan Peristiwa.
Untuk daftar nilai properti awal untuk instans DetailsViewUpdatedEventArgs kelas, lihat DetailsViewUpdatedEventArgs konstruktor.
Konstruktor
| DetailsViewUpdatedEventArgs(Int32, Exception) |
Menginisialisasi instans baru kelas DetailsViewUpdatedEventArgs. |
Properti
| AffectedRows |
Mendapatkan jumlah baris yang terpengaruh oleh operasi pembaruan. |
| Exception |
Mendapatkan pengecualian (jika ada) yang dinaikkan selama operasi pembaruan. |
| ExceptionHandled |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah pengecualian yang dinaikkan selama operasi pembaruan ditangani di penanganan aktivitas. |
| KeepInEditMode |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah DetailsView kontrol harus tetap dalam mode edit setelah operasi pembaruan. |
| Keys |
Mendapatkan kamus yang berisi pasangan nama/nilai bidang kunci untuk rekaman yang diperbarui. |
| NewValues |
Mendapatkan kamus yang berisi pasangan nama/nilai bidang baru untuk rekaman yang diperbarui. |
| OldValues |
Mendapatkan kamus yang berisi pasangan nama/nilai bidang asli untuk rekaman yang diperbarui. |
Metode
| Equals(Object) |
Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object) |
| GetHashCode() |
Berfungsi sebagai fungsi hash default. (Diperoleh dari Object) |
| GetType() |
Mendapatkan instans Type saat ini. (Diperoleh dari Object) |
| MemberwiseClone() |
Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object) |
| ToString() |
Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object) |
