Adicionando registros usando o método AddNew

Esta é a sintaxe básica do método AddNew:

recordset.AddNew FieldList, Values

Os argumentos FieldList e Values são opcionais. FieldList é um só nome ou uma matriz de nomes ou posições ordinais dos campos no novo registro.

O argumento Values é um único valor ou uma matriz de valores para os campos no novo registro.

Normalmente, quando você pretende adicionar um único registro, chama o método AddNew sem argumentos. Mais especificamente, você vai chamar AddNew, definir Value de cada campo no novo registro e chamar Update ou UpdateBatch, ou ambos. Você pode garantir que seu Recordset dê suporte à adição de novos registros usando a propriedade Supports com a constante enumerada adAddNew.

O código a seguir usa essa técnica para adicionar um novo Shipper ao Recordset de exemplo. O SQL Server fornece o valor do campo ShipperID automaticamente. Portanto, o código não tenta fornecer um valor de campo aos novos registros.

'BeginAddNew1.1
If objRs.Supports(adAddNew) Then
    With objRs
        .AddNew
        .Fields("CompanyName") = "Sample Shipper"
        .Fields("Phone") = "(931) 555-6334"
        .Update
    End With
End If
'EndAddNew1.1

Comentários

Como esse código usa um Recordset desconectado com um cursor do lado do cliente no modo de lote, você deve reconectar o Recordset à fonte de dados com um novo objeto Connection antes de poder chamar o método UpdateBatch para postar alterações no banco de dados. Isso é feito facilmente usando a nova função GetNewConnection.