SqlRowUpdatingEventArgs Classe

Definição

Namespace:: System.Data.SqlClient

Assembly:: System.Data.dll

Origem:: System.Data.SqlClient.notsupported.cs

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Fornece dados para o evento RowUpdating.

Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

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

Herança: Object

EventArgs

RowUpdatingEventArgs
SqlRowUpdatingEventArgs

Exemplos

O exemplo a seguir mostra como usar os eventos e RowUpdating os RowUpdated eventos.

O RowUpdating evento retorna esta saída:

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

O RowUpdated evento retorna esta saída:

event 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

Comentários

O RowUpdating evento é gerado antes de uma Update linha.

Quando você estiver usando Update, há dois eventos que ocorrem para cada linha de dados atualizada. A ordem de execução é a seguinte:

Os valores no DataRow são movidos para os valores de parâmetro.
O evento OnRowUpdating foi acionado.
O comando é executado.
Se o comando estiver definido como FirstReturnedRecord, e o primeiro resultado retornado for colocado no DataRow.
Se houver parâmetros de saída, eles serão colocados no DataRow.
O evento OnRowUpdated foi acionado.
AcceptChanges é invocado.

Construtores

Nome	Description
SqlRowUpdatingEventArgs(DataRow, IDbCommand, StatementType, DataTableMapping)	Inicializa uma nova instância da classe SqlRowUpdatingEventArgs. Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

Nome

Description

SqlRowUpdatingEventArgs(DataRow, IDbCommand, StatementType, DataTableMapping)

Inicializa uma nova instância da classe SqlRowUpdatingEventArgs.

Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.

Propriedades

Nome	Description
BaseCommand	Obtém ou define o IDbCommand objeto para uma instância dessa classe. (Herdado de RowUpdatingEventArgs)
Command	Obtém ou define a execução SqlCommand ao executar o Update(DataSet). Para um novo desenvolvimento, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.
Errors	Obtém os erros gerados pelo provedor de dados .NET quando o Command é executado. (Herdado de RowUpdatingEventArgs)
Row	Obtém o DataRow que será enviado ao servidor como parte de uma operação de inserção, atualização ou exclusão. (Herdado de RowUpdatingEventArgs)
StatementType	Obtém o tipo de instrução SQL a ser executada. (Herdado de RowUpdatingEventArgs)
Status	Obtém ou define a UpdateStatus Command propriedade. (Herdado de RowUpdatingEventArgs)
TableMapping	Obtém o DataTableMapping para enviar por meio do Update(DataSet). (Herdado de RowUpdatingEventArgs)

Métodos

Nome	Description
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Objectatual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Aplica-se a

Confira também

Visão geral do ADO.NET

Comentários

Esta página foi útil?