Ajout d’enregistrements à l’aide de la méthode AddNew

Il s’agit de la syntaxe de base de la méthode AddNew :

jeu d’enregistrements. AddNew FieldList, Values

Les arguments FieldList et Values sont facultatifs. FieldList est soit un nom unique, soit un tableau de noms, soit des positions ordinales des champs dans le nouvel enregistrement.

L’argument Valeurs est une valeur unique ou un tableau de valeurs pour les champs du nouvel enregistrement.

En règle générale, lorsque vous envisagez d’ajouter un enregistrement unique, vous appelez la méthode AddNew sans arguments. Plus précisément, vous allez appeler AddNew; définissez la Valeur de chaque champ dans le nouvel enregistrement ; puis appelez Update ou UpdateBatch, ou les deux. Vous pouvez vous assurer que votre jeu d'enregistrements prend en charge l'ajout de nouveaux enregistrements à l'aide de la propriété Supports avec la constante énumérée adAddNew.

Le code suivant utilise cette technique pour ajouter un nouvel expéditeur à l’exemple Recordset. SQL Server fournit automatiquement la valeur du champ ShipperID. Par conséquent, le code n’essaie pas de fournir une valeur de champ pour les nouveaux enregistrements.

'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

Remarques

Étant donné que ce code utilise un jeu d’enregistrements déconnecté avec un curseur côté client en mode batch, vous devez reconnecter le jeu d’enregistrements à la source de données avec un nouvel objet connection Connection avant de pouvoir appeler la méthode UpdateBatch pour publier les modifications apportées à la base de données. Pour ce faire, utilisez facilement la nouvelle fonction GetNewConnection.