SqlCeCommandBuilder.GetUpdateCommand Método

Obtiene el objeto SqlCeCommand generado de forma automática que es necesario para realizar actualizaciones en la base de datos cuando una aplicación llama a Update en SqlCeDataAdapter.

Espacio de nombres:  System.Data.SqlServerCe
Ensamblado:  System.Data.SqlServerCe (en System.Data.SqlServerCe.dll)

Sintaxis

'Declaración
Public Function GetUpdateCommand As SqlCeCommand
'Uso
Dim instance As SqlCeCommandBuilder
Dim returnValue As SqlCeCommand

returnValue = instance.GetUpdateCommand()

public SqlCeCommand GetUpdateCommand()

public:
SqlCeCommand^ GetUpdateCommand()

member GetUpdateCommand : unit -> SqlCeCommand 

public function GetUpdateCommand() : SqlCeCommand

Valor devuelto

Tipo: System.Data.SqlServerCe.SqlCeCommand
Objeto SqlCeCommand generado automáticamente que es necesario para realizar actualizaciones.

Comentarios

Una aplicación puede utilizar el método GetUpdateCommand con fines informativos o para la solución de problemas, porque devuelve el objeto SqlCeCommand que se va a ejecutar.

Además, se puede utilizar GetUpdateCommand como base de un comando modificado. Por ejemplo, se puede llamar a GetUpdateCommand, modificar una de sus propiedades y, a continuación, establecer la propiedad de forma explícita en SqlCeDataAdapter.

Después de generar la instrucción SQL por primera vez, la aplicación debe llamar explícitamente a RefreshSchema() si la aplicación realiza alguna modificación en la instrucción SQL. En caso contrario, GetUpdateCommand sigue utilizando la información de la instrucción anterior, que podría no ser correcta. Las instrucciones SQL se generan por primera vez cuando la aplicación llama a Update o a GetUpdateCommand.

Ejemplos

En el siguiente ejemplo se muestra el uso del método GetUpdateCommand de SqlCeCommandBuilder.

Try
    Dim conn As New SqlCeConnection("Data Source = MyDatabase.sdf")
    conn.Open()

    Dim cmd As SqlCeCommand = conn.CreateCommand()
    cmd.CommandText = "SELECT * FROM employees"

    Dim adp As New SqlCeDataAdapter(cmd)

    Dim cb As New SqlCeCommandBuilder()
    cb.DataAdapter = adp

    MessageBox.Show(cb.GetUpdateCommand().CommandText)
    MessageBox.Show(cb.GetInsertCommand().CommandText)
    MessageBox.Show(cb.GetDeleteCommand().CommandText)

    Dim ds As New DataSet("test")
    adp.Fill(ds)

    ' Modify the contents of the DataSet
    '
    ds.Tables(0).Rows(0)("First Name") = "Joe"

    adp.Update(ds)

Catch e1 As Exception
    Console.WriteLine(e1.ToString())
End Try

try
{
    SqlCeConnection conn = new SqlCeConnection("Data Source = MyDatabase.sdf");
    conn.Open();

    SqlCeCommand cmd = conn.CreateCommand();
    cmd.CommandText = "SELECT * FROM employees";

    SqlCeDataAdapter adp = new SqlCeDataAdapter(cmd);

    SqlCeCommandBuilder cb = new SqlCeCommandBuilder();
    cb.DataAdapter = adp;

    MessageBox.Show(cb.GetUpdateCommand().CommandText);
    MessageBox.Show(cb.GetInsertCommand().CommandText);
    MessageBox.Show(cb.GetDeleteCommand().CommandText);

    DataSet ds = new DataSet("test");
    adp.Fill(ds);

    // Modify the contents of the DataSet
    //
    ds.Tables[0].Rows[0]["First Name"] = "Joe";

    adp.Update(ds);

}
catch (Exception e1)
{
    Console.WriteLine(e1.ToString());
}

Vea también

Referencia

SqlCeCommandBuilder Clase

Sobrecarga de GetUpdateCommand

Espacio de nombres System.Data.SqlServerCe