dotConnect for SQL Server Documentation
Devart.Data.SqlServer Namespace / SqlDataAdapter Class / RowUpdating Event

In This Topic
    RowUpdating Event (SqlDataAdapter)
    In This Topic
    Occurs during System.Data.Common.DbDataAdapter.Update(System.Data.DataSet) before a command is executed against the data source. The attempt to update is made, so the event fires.
    Syntax
    'Declaration
     
    Public Event RowUpdating As SqlRowUpdatingEventHandler
    public event SqlRowUpdatingEventHandler RowUpdating
    Event Data

    The event handler receives an argument of type SqlRowUpdatingEventArgs containing data related to this event. The following SqlRowUpdatingEventArgs properties provide information specific to this event.

    PropertyDescription
    Gets or sets the SqlCommand to execute when System.Data.Common.DbDataAdapter.Update() is called.  
    Gets any errors generated by the .NET Framework data provider when the System.Data.Common.RowUpdatedEventArgs.Command executes. (Inherited from System.Data.Common.RowUpdatingEventArgs)
    Gets the System.Data.DataRow that will be sent to the server as part of an insert, update, or delete operation. (Inherited from System.Data.Common.RowUpdatingEventArgs)
    Gets the type of SQL statement to execute. (Inherited from System.Data.Common.RowUpdatingEventArgs)
    Gets or sets the System.Data.UpdateStatus of the System.Data.Common.RowUpdatedEventArgs.Command property. (Inherited from System.Data.Common.RowUpdatingEventArgs)
    Gets the System.Data.Common.DataTableMapping to send through the System.Data.Common.DbDataAdapter.Update(System.Data.DataSet). (Inherited from System.Data.Common.RowUpdatingEventArgs)
    Remarks
    The event handler receives an argument of type SqlRowUpdatingEventArgs containing data related to this event. The following SqlRowUpdatingEventArgs properties provide information specific to this event.
    Property Description
    SqlRowUpdatedEventArgs.Command Gets the SqlCommand executed when System.Data.Common.DbDataAdapter.Update(System.Data.DataSet) is called.
    Errors (inherited from System.Data.Common.RowUpdatingEventArgs) Gets any errors generated by the .NET data provider when the System.Data.Common.DbDataAdapter.Command(System.Data.DataSet) was executed.
    Row (inherited from System.Data.Common.RowUpdatingEventArgs) Gets the System.Data.DataRow to sent through an System.Data.Common.DbDataAdapter.Update(System.Data.DataSet).
    StatementType (System.Data.Common.RowUpdatingEventArgs) Gets the type of SQL statement to execute.
    Status (inherited from System.Data.Common.RowUpdatingEventArgs) Gets the UpdateStatus of the System.Data.Common.DbDataAdapter.Command(System.Data.DataSet).
    TableMapping (inherited from System.Data.Common.RowUpdatingEventArgs) Gets the DataTableMapping to sent through an System.Data.Common.DbDataAdapter.Update(System.Data.DataSet).

    When using the System.Data.Common.DbDataAdapter.Update(System.Data.DataSet) method, there are two events that occur per data row updated. The order of execution is as follows:

    1. The values in the System.Data.DataRow are moved to the parameter values.
    2. The RowUpdating event is raised.
    3. The command executes.
    4. If the System.Data.UpdateRowSource enumeration is set to System.Data.UpdateRowSource.FirstReturnedRecordS, the first returned result is placed in the System.Data.DataRow.
    5. If there are output parameters, they are placed in the System.Data.DataRow.
    6. The RowUpdated event is raised.
    7. System.Data.DataRow.AcceptChanges is called.
    Requirements

    Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

    See Also