CPDB.Net

https://cpdb.ppcompiler.org/

5- Fonctions de modification d'une base de données (CPDB librairie)

Introduction

Avec CPDB, vous pouvez créer dynamiquement une base de données structurée et ajouter, modifier ou supprimer les enregistrements qu'elle contient. Habituellement, ces traitements nécessite des dizaines de lignes de code.

Voici un exemple qui démontre avec quelle facilité on peut créer une base de données CPDB :

// Création de la base d'utilisateurs
Err errNo;
if (!CPDB_DatabaseExiste("UTILISATEURS"))
{
  errNo = CPDB_CreerDatabase(0, "UTILISATEURS", 'CPDB',
    "NUMERO=INT;NOM=STRING[20];PRENOM=STRING[20];GROUPE=SHORTINT");
}

La base de données est ainsi créée en une seule ligne de code.

Le masque de description est décrit en détail dans la documentation de CPDB_CreerDatabase.

L'ajout d'un enregistrement s'effectue en une seule ligne de code :

// Création d'un nouvel enregistrement
Err errNo;
errNo = CPDB_AjouteEnregistrement(handle);

La variable "handle" correspond au handle d'une base de données préalablement ouverte.

Si aucun enregistrement n'avait été lu précédement, alors un enregistrement vierge est créé, sinon le nouvel enregistrement est une copie de l'enregistrement en cours de lecture (ou de modification).

Pour être sûr de créer un enregistrement vierge utilisez la fonction CPDB_RAZ.

Pour supprimer un enregistrement, utilisez la fonction CPDB_SupprimeEnregistrement.

Modification d'un enregistrement

Les rubriques d'un enregistrement sont modifiables par l'utilisation des fonctions CPDB_EcrireEntierCourt, CPDB_EcrireEntier, CPDB_EcrireEntierLong et CPDB_EcrireChaine.

Une fois les rubriques modifiées, il faut soit mettre à jour l'enregistrement courant par CPDB_MetAJourEnregistrement, soit créer un nouvel enregistrement par CPDB_AjouteEnregistrement.

Err errNo;


// Mise à jour des rubriques d'un enregistrement
CPDB_RAZ(handle);
errNo = CPDB_EcrireEntier(handle, "NUMERO", iNumero);
errNo = CPDB_EcrireChaine(handle, "NOM", sNom);
errNo = CPDB_EcrireEntierCourt(handle, "GROUPE", iGroupe);

if ( bModeAjout )
{
  // Création d'un nouvel enregistrement
  errNo = CPDB_AjouteEnregistrement(handle);
}
else
{
  // Modification de l'enregistrement courant
  errNo = CPDB_MetAJourEnregistrement(handle);
}

Plus d'informations

CPDB_AjouteEnregistrement

CPDB_CreerDatabase

CPDB_EcrireEntierCourt

CPDB_EcrireEntier

CPDB_EcrireEntierLong

CPDB_EcrireChaine

CPDB_MetAJourEnregistrement

CPDB_RAZ

CPDB_SupprimeEnregistrement