Insertion d'un enregistrement

La fonction la plus couramment manipuler dans une base de données est sans aucun doute l'insertion d'un enregistrement.

Par un souci de clarté, nous avons décidé de ne prendre en compte que 2 champs dans la table (IdEleve qui est un nombre, et NomE qui est une chaîne de caractères). La procédure à suivre pour les autres champs (PrénomE, Age et AnneeEtude) est identiques.

Dans cette fonction, deux variables locales sont utilisées :

• nb, qui est un entier, et

• EntreeNom, un TextBox dont la valeur est accessible dpar l'intermédiaire de son champ Text.
  

* Visual Basic :
'ouvre un recordset dans la table Eleve
rst = db.OpenRecordset("Eleve")
'création d'un nouvel enregistrement
rst.AddNew()
'ajout des valeurs de champ
rst("IdEleve").Value = nb
rst("NomE").Value = EntreeNom.Text
'mise à jour de la table
rst.Update()
'fermeture du recordset
rst.Close()

Le VB donne la possibilité aux développeurs d'inserer un enregistrement à l'aide d'un RecordSet, ouvert sur la table Eleve. Il faut ensuite ajouter un nouvel enregistrement (AddNew), et définir ses valeurs de champs. Enfin, il est absolument indispensable d'enregsitrer dans la table les modifications (Update).

* C++ :
//ouvre un recordset dans la table Eleve
rst $\rightarrow$ Open( dbOpenDynaset, "SELECT * FROM Eleve" ) ;
//création d'un nouvel enregistrement
rst $\rightarrow$ AddNew();
//ajout des valeurs de champ

var.Clear();
itoa(nb,str2,10);
var.SetString(str2,VT_BSTRT);
rst $\rightarrow$ SetFieldValue("IdEleve",var);

var.Clear();
strcpy( str2,StringToChar(EntreeNom $\rightarrow$ Text));
var.SetString(str2,VT_BSTRT);
rst $\rightarrow$ SetFieldValue("NomE",var);

//mise à jour de la table
rst $\rightarrow$ Update();
//fermeture du recordset
rst $\rightarrow$ Close();

Dans le cas du C++, plusieurs remarques sont à faire.

• Il faut premièrement fixer le type d'ouverture du RecordSet : dbOpenDynaset (permet de modifier la base de données).
• De plus, nous devons sélectionner la table concernée (ici, en sélectionnant tous les enregistrements de la table Eleve). Nous avons essayé de mettre seulement "Eleve", mais le recordSet ne fonctionnait plus.
• Ensuite, nous réalisons les mêmes actions que pour le VB, nous déclarons un nouvel enregistrement, que l'on initialise et que l'on ajoute réellement.

Mais la principale difficulté résidait dans les conversions des variables. En effet, la fonction SetFieldValue prend comme paramètre un type peu commun en C++ : le COleVariant. Nous avons donc déclarer une variable locale de type COleVariant : COleVariant var;. Ce type est en réalité le Variant du VB, il permet de transformer n'importe quel type en un autre type. Nous avons de plus utiliser une variable (str2) de type CHAR (tableau de chars) pour réaliser une première conversion du type INT vers CHAR * (avec le str2), puis du type char * vers BSTRT pour enfin envoyer la variable var dans la fonction SetFieldValue ! La conversion peut sembler compliquée, elle est néanmoins obligatoire.

* C# :
//ouvre un recordset dans la table Eleve
rst = db.OpenTable("Eleve",
DAO.RecordsetOptionEnum.dbConsistent);
//création d'un nouvel enregistrement
rst.AddNew();

//ajout des valeurs de champ
rst.set_Collect("IdEleve",nb);
rst.set_Collect("NomE",EntreeNom.Text);
//mise à jour de la table
rst.Update(1,false);
//fermeture du recordset
rst.Close();

Pour le C#, l'idée reste identique : ouverture d'un RecordSet, création d'un enregistrement, affectation des valeurs et sauvegarde des modification.

Une petite différence cependant, la fonction OpenTable doit avoir un paramètre Options, que nous avons défini comme dbConsistent, c'est à dire que les modifications que nous allons entreprendre doivent être prise en compte dans la base de données.

Avec le C#, le problème des conversions est totalement effacé, la fonction set_Collect gère très bien tous les types de données.

* MySQL :
//Création de la requête
$query="INSERT INTO Eleve ( IdEleve, NomE, PrénomE,Age
,AnneeEtude) VALUES(etc...) ";
//On lance la requête
$resultat=mysql_query($query,$db);

* ASP :
'Création d'un RecordSet
SET MonRs = Serveur.CreateObject("ADODB.Recordset");
'Initialisation du RecordSet
MonRs.Open "INSERT INTO Eleve ( IdEleve, NomE, PrénomE
,Age,AnneeEtude) VALUES(etc...)",Connexion

Pour les langages MyQL et ASP, l'insertion d'un enregistrement s'effectue en SQL, dans une requête pour le MySQL, et dans un RecordSet pour l'ASP.

Aucune mise à jour n'est nécessaire, la fonction INSERT de SQL le fait automatiquement.