Método SqlCeResultSet.Insert (SqlCeUpdatableRecord)

Artigo
05/27/2011

Insere o SqlCeUpdatableRecord especificado no conjunto de linhas subjacente.

Namespace: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (em System.Data.SqlServerCe.dll)

Sintaxe

'Declaração
Public Sub Insert ( _
    record As SqlCeUpdatableRecord _
)
'Uso
Dim instance As SqlCeResultSet
Dim record As SqlCeUpdatableRecord

instance.Insert(record)

public void Insert(
    SqlCeUpdatableRecord record
)

public:
void Insert(
    SqlCeUpdatableRecord^ record
)

member Insert : 
        record:SqlCeUpdatableRecord -> unit

public function Insert(
    record : SqlCeUpdatableRecord
)

Parâmetros

record
Tipo: System.Data.SqlServerCe.SqlCeUpdatableRecord
O registro a ser inserido.

Comentários

A inserção de um registro não altera a posição atual do SqlCeResultSet.

A chamada dessa função executa a inserção imediatamente, sem exigir que chamadas adicionais para concluir a operação.

Uma exceção será lançada se o registro especificado tiver mais colunas que o conjunto de linhas subjacente definiu. Se forem especificados menos valores, as colunas restantes deverão permitir valores null ou ter um valor padrão definido.

Uma InvalidOperationException será lançada se esta função for chamada em um SqlCeResultSet não atualizável ou se o leitor não estiver posicionado em um registro válido.

Exemplos

Dim conn As SqlCeConnection = Nothing

Try
    File.Delete("Test.sdf")

    Dim engine As New SqlCeEngine("Data Source = Test.sdf")
    engine.CreateDatabase()

    conn = New SqlCeConnection("Data Source = Test.sdf")
    conn.Open()

    Dim cmd As SqlCeCommand = conn.CreateCommand()
    cmd.CommandText = "CREATE TABLE myTable (col1 INT)"
    cmd.ExecuteNonQuery()

    cmd.CommandText = "SELECT * FROM myTable"

    Dim rs As SqlCeResultSet = cmd.ExecuteResultSet(ResultSetOptions.Updatable Or ResultSetOptions.Scrollable)

    Dim rec As SqlCeUpdatableRecord = rs.CreateRecord()

    ' Insert 10 records
    '
    Dim i As Integer
    For i = 0 To 9
        rec.SetInt32(0, i)
        rs.Insert(rec)
    Next i

    ' Update the 5th record
    '
    If True = rs.ReadAbsolute(5) Then
        rs.SetInt32(0, 55)
        rs.Update()
    End If

    ' Delete the 2nd record
    '
    If True = rs.ReadAbsolute(2) Then
        rs.Delete()
    End If
Catch e As Exception
    MessageBox.Show(e.Message)
Finally
    conn.Close()
End Try

SqlCeConnection conn = null;

try
{
    File.Delete("Test.sdf");

    SqlCeEngine engine = new SqlCeEngine("Data Source = Test.sdf");
    engine.CreateDatabase();

    conn = new SqlCeConnection("Data Source = Test.sdf");
    conn.Open();

    SqlCeCommand cmd = conn.CreateCommand();
    cmd.CommandText = "CREATE TABLE myTable (col1 INT)";
    cmd.ExecuteNonQuery();

    cmd.CommandText = "SELECT * FROM myTable";

    SqlCeResultSet rs = cmd.ExecuteResultSet(ResultSetOptions.Updatable |
        ResultSetOptions.Scrollable);

    SqlCeUpdatableRecord rec = rs.CreateRecord();

    // Insert 10 records
    //
    for (int i = 0; i < 10; i++)
    {
        rec.SetInt32(0, i);
        rs.Insert(rec);
    }

    // Update the 5th record
    //
    if (true == rs.ReadAbsolute(5))
    {
        rs.SetInt32(0, 55);
        rs.Update();
    }

    // Delete the 2nd record
    //
    if (true == rs.ReadAbsolute(2))
    {
        rs.Delete();
    }
}
catch (Exception e)
{
    MessageBox.Show(e.Message);
}
finally
{
    conn.Close();
}

Consulte também

Referência

SqlCeResultSet Classe

Sobrecarregado Insert

Namespace System.Data.SqlServerCe

Compartilhar via