SqlCeCommandBuilder.GetInsertCommand Método

Obtiene el objeto SqlCeCommand generado de forma automática que es necesario para realizar inserciones 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 GetInsertCommand As SqlCeCommand
'Uso
Dim instance As SqlCeCommandBuilder
Dim returnValue As SqlCeCommand

returnValue = instance.GetInsertCommand()

public SqlCeCommand GetInsertCommand()

public:
SqlCeCommand^ GetInsertCommand()

member GetInsertCommand : unit -> SqlCeCommand 

public function GetInsertCommand() : SqlCeCommand

Valor devuelto

Tipo: System.Data.SqlServerCe.SqlCeCommand
Objeto SqlCeCommand generado de forma automática que es necesario para realizar inserciones.

Comentarios

Una aplicación puede utilizar el método GetInsertCommand 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 GetInsertCommand como base de un comando modificado. Por ejemplo, se puede llamar a GetInsertCommand, 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. En caso contrario, GetInsertCommand 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 GetInsertCommand.

Ejemplos

En el siguiente ejemplo se muestra el uso del método GetInsertCommand 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 GetInsertCommand

Espacio de nombres System.Data.SqlServerCe