SqlRowUpdatingEventArgs Klas

Definitie

Biedt gegevens voor de RowUpdating gebeurtenis.

public ref class SqlRowUpdatingEventArgs sealed : System::Data::Common::RowUpdatingEventArgs
public sealed class SqlRowUpdatingEventArgs : System.Data.Common.RowUpdatingEventArgs
type SqlRowUpdatingEventArgs = class
    inherit RowUpdatingEventArgs
Public NotInheritable Class SqlRowUpdatingEventArgs
Inherits RowUpdatingEventArgs
Overname
SqlRowUpdatingEventArgs

Voorbeelden

In het volgende voorbeeld ziet u hoe u zowel de als de RowUpdatingRowUpdated gebeurtenissen gebruikt.

De RowUpdating gebeurtenis retourneert deze uitvoer:

gebeurtenis args: (command=System.Data.SqlClient.SQLCommand commandType=2 status=0)

De RowUpdated gebeurtenis retourneert deze uitvoer:

gebeurtenis args: (command=System.Data.SqlClient.SQLCommand commandType=2 recordsAffected=1 row=System.Data.DataRow[37] status=0)

// handler for RowUpdating event
private static void OnRowUpdating(object sender, SqlRowUpdatingEventArgs e)
{
    PrintEventArgs(e);
}

//Handler for RowUpdated event.
private static void OnRowUpdated(object sender, SqlRowUpdatedEventArgs e)
{
    PrintEventArgs(e);
}

public static int Main()
{
    const string CONNECTION_STRING = "Persist Security Info=False;Integrated Security=SSPI;database=northwind;server=mySQLServer";
    const string SELECT_ALL = "select * from Products";

    //Create DataAdapter.
    SqlDataAdapter rAdapter    = new SqlDataAdapter(SELECT_ALL, CONNECTION_STRING);

    //Create and fill DataSet (Select only first 5 rows.).
    DataSet rDataSet = new DataSet();
    rAdapter.Fill(rDataSet, 0, 5, "Table");

    //Modify DataSet.
    DataTable rTable = rDataSet.Tables["Table"];
    rTable.Rows[0][1] = "new product";

    //Add handlers.
    rAdapter.RowUpdating += new SqlRowUpdatingEventHandler( OnRowUpdating );
    rAdapter.RowUpdated += new SqlRowUpdatedEventHandler( OnRowUpdated );

    //Update--this operation fires two events (RowUpdating and RowUpdated) for each changed row.
    rAdapter.Update(rDataSet, "Table");

    //Remove handlers.
    rAdapter.RowUpdating -= new SqlRowUpdatingEventHandler( OnRowUpdating );
    rAdapter.RowUpdated -= new SqlRowUpdatedEventHandler( OnRowUpdated );
    return 0;
}

private static void PrintEventArgs(SqlRowUpdatingEventArgs args)
{
    Console.WriteLine("OnRowUpdating");
    Console.WriteLine("  event args: ("+
        " command=" + args.Command +
        " commandType=" + args.StatementType +
        " status=" + args.Status + ")");
}

private static void PrintEventArgs(SqlRowUpdatedEventArgs args)
{
    Console.WriteLine("OnRowUpdated");
    Console.WriteLine("  event args: ("+
        " command=" + args.Command +
        " commandType=" + args.StatementType +
        " recordsAffected=" + args.RecordsAffected +
        " status=" + args.Status + ")");
}
'Handler for RowUpdating event.
Private Shared Sub OnRowUpdating(sender As Object, e As SqlRowUpdatingEventArgs)
    PrintEventArgs(e)
End Sub 

'Handler for RowUpdated event.
Private Shared Sub OnRowUpdated(sender As Object, e As SqlRowUpdatedEventArgs)
    PrintEventArgs(e)
End Sub 

'Entry point which delegates to C-style main Private Function.
Public Overloads Shared Sub Main()
    System.Environment.ExitCode = Main(System.Environment.GetCommandLineArgs())
End Sub

Overloads Public Shared Function Main(args() As String) As Integer
    Const CONNECTION_STRING As String = "Persist Security Info=False;Integrated Security=SSPI;database=northwind;server=mySQLServer"
    Const SELECT_ALL As String = "select * from Products"
    
    'Create DataAdapter.
    Dim rAdapter As New SqlDataAdapter(SELECT_ALL, CONNECTION_STRING)
    
    'Create and fill DataSet (Select only first 5 rows.).
    Dim rDataSet As New DataSet()
    rAdapter.Fill(rDataSet, 0, 5, "Table")
    
    'Modify DataSet.
    Dim rTable As DataTable = rDataSet.Tables("Table")
    rTable.Rows(0)(1) = "new product"
    
    'Add handlers.
    AddHandler rAdapter.RowUpdating, AddressOf OnRowUpdating
    AddHandler rAdapter.RowUpdated, AddressOf OnRowUpdated
    
    'Update--this operation fires two events (RowUpdating and RowUpdated) for each changed row. 
    rAdapter.Update(rDataSet, "Table")
    
    'Remove handlers.
    RemoveHandler rAdapter.RowUpdating, AddressOf OnRowUpdating
    RemoveHandler rAdapter.RowUpdated, AddressOf OnRowUpdated
    Return 0
End Function 

Overloads Private Shared Sub PrintEventArgs(args As SqlRowUpdatingEventArgs)
    Console.WriteLine("OnRowUpdating")
    Console.WriteLine("  event args: (" & _
                    " command=" & _
                    args.Command.CommandText & _
                    " commandType=" & _
                    args.StatementType & _
                    " status=" & _
                    args.Status & _
                    ")")
End Sub 


Overloads Private Shared Sub PrintEventArgs(args As SqlRowUpdatedEventArgs)
    Console.WriteLine("OnRowUpdated")
    Console.WriteLine("  event args: (" & _
                    " command=" & _
                    args.Command.CommandText & _
                    " commandType=" & _
                    args.StatementType & _
                    " recordsAffected=" & _
                    args.RecordsAffected & _
                    " status=" & _
                    args.Status & _
                    ")")
End Sub

Opmerkingen

De RowUpdating gebeurtenis wordt gegenereerd vóór een Update rij.

Wanneer u gebruikt Update, zijn er twee gebeurtenissen die optreden voor elke gegevensrij die wordt bijgewerkt. De uitvoeringsvolgorde is als volgt:

  1. De waarden in de waarden DataRow worden verplaatst naar de parameterwaarden.

  2. De OnRowUpdating gebeurtenis wordt gegenereerd.

  3. De opdracht wordt uitgevoerd.

  4. Als de opdracht is ingesteld op FirstReturnedRecord, en het eerste geretourneerde resultaat in de DataRow.

  5. Als er uitvoerparameters zijn, worden ze in de DataRow.

  6. De OnRowUpdated gebeurtenis wordt gegenereerd.

  7. AcceptChanges wordt aangeroepen.

Constructors

Name Description
SqlRowUpdatingEventArgs(DataRow, IDbCommand, StatementType, DataTableMapping)

Initialiseert een nieuw exemplaar van de SqlRowUpdatingEventArgs klasse.

Eigenschappen

Name Description
BaseCommand

Hiermee wordt het IDbCommand object opgehaald of ingesteld voor een exemplaar van deze klasse.

(Overgenomen van RowUpdatingEventArgs)
Command

Hiermee haalt u de uitvoering op of stelt u deze SqlCommand in bij het uitvoeren van de Update(DataSet).

Errors

Hiermee worden eventuele fouten opgehaald die door de .NET gegevensprovider worden gegenereerd wanneer de Command wordt uitgevoerd.

(Overgenomen van RowUpdatingEventArgs)
Row

Hiermee haalt u de DataRow gegevens op die naar de server worden verzonden als onderdeel van een invoeg-, update- of verwijderbewerking.

(Overgenomen van RowUpdatingEventArgs)
StatementType

Hiermee haalt u het type SQL-instructie op dat moet worden uitgevoerd.

(Overgenomen van RowUpdatingEventArgs)
Status

Hiermee haalt u de UpdateStatus eigenschap op of stelt u deze Command in.

(Overgenomen van RowUpdatingEventArgs)
TableMapping

Hiermee wordt het DataTableMapping te verzenden via de Update(DataSet).

(Overgenomen van RowUpdatingEventArgs)

Methoden

Name Description
Equals(Object)

Bepaalt of het opgegeven object gelijk is aan het huidige object.

(Overgenomen van Object)
GetHashCode()

Fungeert als de standaardhashfunctie.

(Overgenomen van Object)
GetType()

Hiermee haalt u de Type huidige instantie op.

(Overgenomen van Object)
MemberwiseClone()

Hiermee maakt u een ondiepe kopie van de huidige Object.

(Overgenomen van Object)
ToString()

Retourneert een tekenreeks die het huidige object vertegenwoordigt.

(Overgenomen van Object)

Van toepassing op

Zie ook