This article was translated by machine. To view in the article in English, select the English check box. You can also display the English text in a popup window by moving the mouse pointer over the text.
الترجمة
الأصلي
This documentation is archived and is not being maintained.

DetailsViewUpdatedEventArgs الفئة

Visual Studio 2010

يوفر بيانات ل ItemUpdatedحدث.

مساحة الاسم:  System.Web.UI.WebControls
التجميع:  System.Web (في System.Web.dll)

public class DetailsViewUpdatedEventArgs : EventArgs

DetailsView عنصر تحكم يرفع ItemUpdatedحدث عندما يظهر زر التحديث (زر مع به CommandNameتعيين الخاصية إلى "تحديث") داخل عنصر تحكم النقر فوق، ولكن بعد DetailsViewعنصر تحكم تحديث السجل. يسمح لك هذا إلى توفر معالج أحداث الذي يؤدي روتين cusإلىm، مثل تدقيق نتائج عملية تحديث، عند إجراء هذا حدث.

قم بإدراج معين DetailsViewUpdatedEventArgsكائن إلى مجموعة في الموقع الفهرس المحدد. إلى determine the رقم of records affected بواسطة the تحديث تشغيل, استخدم the AffectedRows خاصية. استخدام Exceptionخاصية لتحديد ما إذا حدث أي استثناءات. فهرس صفيفة عنده إلى إضافة ExceptionHandledالكائن. إذا كنت بحاجة للوصول إلى حقل المفتاح قيم سجل محدث، استخدم Keysالخاصية. الأصلي وتم تحديث غير-حقل المفتاح قيم يمكن الوصول إلى استخدام OldValuesو NewValuesالخصائص، على التوالي.

بواسطة الافتراضي, the DetailsView عنصر تحكم إرجاع إلى the الوضع specified بواسطة the DefaultMode خاصية بعد an تحديث تشغيل. إلى احتفظ the DetailsView عنصر تحكم في تحرير الوضع, التعيين the KeepInEditMode خاصية إلى true.

للحصول على مزيد من المعلومات حول معالجة الأحداث، راجع استهلاك الأحداث.

للحصول على قائمة الأولى قيم الخاصية لمثيل DetailsViewUpdatedEventArgsللفئات، راجع DetailsViewUpdatedEventArgsالمنشئ.

The following code example demonstrates how to use the DetailsViewUpdatedEventArgs object passed to the event handler for the ItemUpdated event to determine whether an exception occurred during an update operation.



<%@ 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>



System.Object
  System.EventArgs
    System.Web.UI.WebControls.DetailsViewUpdatedEventArgs

يتم تأمين العملية الجزئية لأي عضو عمومي ثابت (مشترك في Visual Basic) من هذا النوع. لن يتم ضمان تأمين العملية الجزئية لأي عضو مثيل.

نظام التشغيل Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, الإصدار x64 من نظام التشغيل Windows XP Professional, Windows XP Starter Edition, Windows Server 2008, نظام التشغيل Windows Server 2003, نظام التشغيل Windows Server 2000 المزود بحزمة الخدمة SP4, نظام التشغيل Windows Millennium Edition, نظام التشغيل Windows 98

لا يدعم .NET Framework و .NET Compact Framework كافة الإصدارات الخاصة بكل نظام أساسي. للحصول على قائمة بالإصدارات المدعمة، راجع متطلبات النظام إطار عمل .NET.

.NET Framework

مدعوم في: 4, 3.5, 3.0, 2.0
إظهار: