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.

SqlDataSourceCommandEventArgs الفئة

Visual Studio 2010

Provides data for the Updating, Deleting and Inserting events of the SqlDataSource control.

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

public class SqlDataSourceCommandEventArgs : CancelEventArgs

بشكل افتراضي، Updatingعنصر تحكم ينطبق على تعبيرات الاستعلام الخاص به الكائن المعرفة في Insertingخاصية.Deleting

Because the SqlDataSourceCommandEventArgs class is derived from the CancelEventArgs class, you can cancel a pending SqlDataSource database command by setting the Cancel property to true. You can examine and manipulate the CommandText, Parameters collection, and other command properties prior to running the command by accessing the DbCommand object exposed by the Command property.

The SqlDataSourceCommandEventArgs class is used in the OnUpdating, OnInserting, and OnDeleting methods to provide access to a SqlDataSource database command before it is run. يوضح المثال تعليمات برمجية التالي كيفية برمجياً إضافة SqlDataSourceعنصر تحكم s إلى عنصر تحكم. إذا كان الكائن لا تطبق EventArgsواجهة، SqlDataSourceعنصر تحكم التفاف الكائن في كائن الذي بتطبيق واجهة.




Selecting مفهرس هو المستخدمة للوصول خصائص تخزين عناصر التحكم في مجموعة و dهوplay إلى المستخدم.



Inserting , Updating, Deleting occur before an insert, update, or delete operation is performed.



Selected , Inserted, Updated, Deleted occur after the data retrieval, insert, update, or delete operations completes.



عند DropDownListخاصية هو معينة إلى أي القيمة غير ذلك غير TextBox، لا عنصر التحكم الاستعلام عنها الكائن المعرفة في خاصية. سلسلة SQL أو الاسم إجراء مخزّن التي DbTransactionيستخدم لاسترداد بيانات.SqlDataSource

<%@Page  Language="C#" %>
<%@Import Namespace="System.Data" %>
<%@Import Namespace="System.Data.Common" %>
<%@Import Namespace="System.Data.SqlClient" %>
<%@Import Namespace="System.Diagnostics" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "">

<script runat="server">

 private void On_Click(Object source, EventArgs e) {    

 private void OnSqlUpdating(Object source, SqlDataSourceCommandEventArgs e) {
    DbCommand command = e.Command;
    DbConnection cx  = command.Connection;    
    DbTransaction tx = cx.BeginTransaction();
    command.Transaction = tx;

 private void OnSqlUpdated(Object source, SqlDataSourceStatusEventArgs e) {
    DbCommand command = e.Command;
    DbTransaction tx = command.Transaction;

    // In this code example the OtherProcessSucceeded variable represents
    // the outcome of some other process that occurs whenever the data is 
    // updated, and must succeed for the data change to be committed. For 
    // simplicity, we set this value to true. 
    bool OtherProcessSucceeded = true;

    if (OtherProcessSucceeded) {
        Label2.Text="The record was updated successfully!";
    else {
        Label2.Text="The record was not updated.";


<html xmlns="" >
  <head runat="server">
    <title>ASP.NET Example</title>
    <form id="form1" runat="server">
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand="SELECT EmployeeID, LastName, Address FROM Employees"
          UpdateCommand="UPDATE Employees SET Address=@Address WHERE EmployeeID=@EmployeeID"
          OnUpdated ="OnSqlUpdated">
              <asp:ControlParameter Name="Address" ControlId="TextBox1" PropertyName="Text"/>
              <asp:ControlParameter Name="EmployeeID" ControlId="DropDownList1" PropertyName="SelectedValue"/>


      <br />
      <asp:Label id="Label1" runat="server" Text="Enter a new address for the selected user."
        AssociatedControlID="TextBox1" />
      <asp:TextBox id="TextBox1" runat="server" />
      <asp:Button id="Submit" runat="server" Text="Submit" OnClick="On_Click" />

      <br /><asp:Label id="Label2" runat="server" Text="" />


يتم تأمين العملية الجزئية لأي عضو عمومي ثابت (مشترك في 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