CDaoTableDef::CreateField

void CreateField (LPCTSTR lpszNamecourt nType, long lSize,longlAttributes= 0 );
jeter (CDaoException, CMemoryException);

void Cre&ateField (CDaoFieldInfoamp ;FieldInfo );
jeter (CDaoException, CMemoryException);

Paramètres

lpszName

Un pointeur vers une expression de chaîne spécifiant le nom de ce champ.

nType

Une valeur qui indique le type de données du champ. Le paramètre peut être une de ces valeurs:

Type Taille (octets) Description
dbBoolean 1 octet BOOL
dbByte 1 OCTETS
dbInteger 2 int
dbLong 4 long
dbCurrency 8 Monnaie (COleCurrency)
dbSingle 4 flotteur
dbDouble 8 double
dbDate 8 Date/heure (COleDateTime)
dbText 1-255 Texte (CString)
dbLongBinary 0 Long Binary (objet OLE), CLongBinary ou CByteArray
dbMemo 0 Mémo (CString)

lSize

Une valeur qui indique la taille maximale, en octets, d'un champ qui contient du texte, ou la taille fixe d'un champ qui contient les valeurs texte ou numérique. Le paramètre lSize est ignoré pour tous les champs de texte.

lAttributes

Une valeur correspondant aux caractéristiques du champ et qui peut être combinée à l'aide d'un opérateur de bits OR-.

Constante Description
dbFixedField La taille du champ est fixe (valeur par défaut pour les champs numériques).
dbVariableField La taille du champ est variable (champs de texte seulement).
dbAutoIncrField La valeur du champ pour les nouveaux enregistrements est automatiquement incrémentée pour un unique entier long qui ne peut pas être modifié. Pris en charge uniquement pour les tables de la base de données Microsoft Jet.
dbUpdatableField La valeur du champ peut être modifiée.
dbDescending Le champ est trié en décroissant (Z-A ou 100-0) ordre (s'applique uniquement à un objet Field dans une collection de champs d'un objet Index). Si vous omettez cette constante, le champ est trié par ordre croissant (A-Z ou 0 – 100) ordonnance (par défaut).

fieldinfo

Une référence à une structure de CDaoFieldInfo.

Remarques

Appelez cette fonction membre pour ajouter un champ à la table. Un objet DAOField (OLE) est créé et ajouté à la collection Fields de l'objet DAOTableDef (OLE). Outre son utilisation pour examiner les propriétés de l'objet, vous pouvez également utiliser CDaoFieldInfo pour construire un paramètre d'entrée pour la création de nouveaux champs dans un objet tabledef. La première version de CreateField est plus simple à utiliser, mais si vous souhaitez contrôler plus fine, vous pouvez utiliser la deuxième version de CreateField, qui prend un paramètre de CDaoFieldInfo.

Si vous utilisez la version de CreateField qui prend un paramètre CDaoFieldInfo , vous devez définir avec soin chacun des membres de la structure CDaoFieldInfo:

Les membres restants de CDaoFieldInfo doivent être définis sur 0, FALSEou une chaîne vide, comme il convient pour le membre, ou un CDaoException peut se produire.

Pour plus d'informations sur les objets tabledef, consultez les articles Tabledef DAO et Tabledef DAO: à l'aide d'objets tabledef dans le Guide du programmeur Visual C++. Pour plus d'informations, consultez la rubrique « Méthode CreateField » dans l'aide de DAO.

Aperçu CDaoTableDef |  ; Membres de la classe | Graphique de la hiérarchie

Voir aussi  ;CDaoTableDef::DeleteField, CDaoTableDef::CreateIndex, CDaoTableDef::DeleteIndex

Index