CSTR

Syntaxe

Paramètres

Description

Cette fonction permet de convertir un type de données quelconque à un format de chaine de caractères.

Remarques

• La fonction convertit une expression en chaîne de caractères : La fonction CStr transforme une expression de n'importe quel type compatible en une valeur de type String. Le résultat obtenu est une chaîne de caractères pouvant être affichée, concaténée ou manipulée avec les fonctions de traitement de texte. Cette conversion est très courante dans les applications Microsoft Access.
• Elle accepte une grande variété de types de données : Le paramètre peut être un nombre, une date, une valeur booléenne, une variable, un champ de table ou encore le résultat d'une expression. CStr convertit automatiquement cette valeur en texte selon les règles de conversion de VBA. Cette polyvalence en fait l'une des fonctions de conversion les plus utilisées.
• Les dates et les nombres sont convertis selon les paramètres régionaux : Lorsqu'une date ou un nombre est converti avec CStr, le résultat respecte généralement les paramètres régionaux définis dans Windows. Par exemple, le séparateur décimal, le format de la date ou l'ordre jour/mois/année peuvent varier selon la configuration du système. Il faut donc tenir compte de ce comportement lors de l'échange de données entre différents environnements.
• La fonction est très utile pour construire des messages : CStr est souvent utilisée pour convertir des valeurs numériques ou des dates avant de les concaténer avec du texte. Par exemple, elle permet de créer facilement des messages comme "Le total est : 1250" ou "Date de livraison : 26/06/2026". Cette technique est couramment employée dans les formulaires et les boîtes de dialogue.
• Elle facilite la concaténation de différents types de données : Bien que VBA réalise parfois des conversions automatiques, utiliser CStr garantit que l'expression est bien traitée comme une chaîne de caractères. Cette conversion explicite améliore la lisibilité du code et réduit les risques d'erreurs lors de l'assemblage de plusieurs valeurs dans une même chaîne. Elle constitue donc une bonne pratique de programmation.
• Une valeur Null ne produit pas une chaîne vide : Si l'expression fournie contient la valeur Null, la fonction CStr retourne également Null et non une chaîne vide (""). Ce comportement peut entraîner des résultats inattendus lors de concaténations ou de comparaisons. Pour éviter ce problème, il est fréquent de combiner CStr avec la fonction Nz, qui remplace les valeurs Null par une valeur par défaut.
• Elle est disponible dans les requêtes et dans le code VBA : La fonction CStr peut être utilisée dans les requêtes SQL, les formulaires, les états, les contrôles calculés ainsi que dans les modules VBA. Cette disponibilité permet de convertir directement des données lors de leur affichage ou de leur traitement. Elle évite souvent la création de fonctions personnalisées uniquement destinées à convertir des valeurs en texte.
• Elle appartient à la famille des fonctions de conversion de VBA : CStr fait partie des fonctions de conversion telles que CBool, CByte, CCur, CDate, CDbl, CDec, CInt, CLng et CSng. Toutes ces fonctions permettent de convertir explicitement une valeur vers un type de données précis. Leur utilisation améliore la lisibilité du code et facilite sa maintenance.
• Elle est très utilisée lors des exportations et des affichages : Avant d'exporter des données vers un fichier texte, un fichier CSV ou une interface utilisateur, il est souvent nécessaire de convertir les valeurs en chaînes de caractères. CStr simplifie cette opération tout en assurant une représentation textuelle cohérente des données. Elle est également utile pour préparer des journaux d'événements (logs) ou des rapports.
• La fonction est compatible avec toutes les versions modernes de Microsoft Access : La fonction CStr est présente depuis les premières versions de Microsoft Access intégrant VBA et son comportement est demeuré stable au fil des versions. Elle est compatible avec Access 2000, Access XP, Access 2003, Access 2007, Access 2010, Access 2013, Access 2016 ainsi qu'avec Microsoft 365. Cette stabilité garantit que les applications utilisant CStr peuvent être migrées vers des versions plus récentes sans modification de leur logique de conversion.

Exemple de code VBA

La fonction CStr peut être utilisée dans le code VBA de Microsoft Access.

Par exemple :

La variable LValue contiendrait désormais la valeur de chaîne «8».