|
|
|
|
|
|
|
|
|
|
- Contenu des cellules : prise en compte des lignes et colonnes vides
- Gestion des erreurs
- Type de donnée récupérée
xlsDonnée (Fonction) En anglais : xlsData Récupère le contenu d'une cellule d'un fichier XLS. Selon le mode d'ouverture du fichier XLS, le résultat peut varier : - En mode multi-feuilles, la donnée récupérée est située sur la feuille sélectionnée avec la fonction xlsFeuilleEnCours.
- En mode compatible, la donnée récupérée est toujours située sur la première feuille du classeur.
Remarque : Le contenu d'une cellule d'un fichier XLS peut être récupéré uniquement si : - Le fichier XLS existe.
- Le fichier XLS est ouvert.
 Nouveauté 2025
ResDonnée est une chaîne
IDFichierXLS est un entier
IDFichierXLS = xlsOuvre("C:\MonRépertoire\Fichier.XLS")
SI IDFichierXLS <> -1 ALORS
ResDonnée = xlsDonnée(IDFichierXLS, 3, 4)
...
FIN
cMonFicXLS est un xlsDocument
cMonFicXLS = xlsOuvre(sMonFichier, xlsEcriture)
SI ErreurDétectée = Faux ALORS
Azz est un entier = xlsFeuilleEnCours(cMonFicXLS)
Info("Feuille en cours dans le fichier Excel : " + Azz)
SI xlsFeuilleEnCours(cMonFicXLS, 2) = Vrai ALORS
Info("La feuille courante a été modifiée.")
Info(xlsDonnée(cMonFicXLS, 11, 2))
SINON
Erreur("Le fichier sélectionné ne comporte pas de seconde feuille !")
FIN
SINON
Erreur(ErreurInfo(errComplet))
FIN
xlsFerme(cMonFicXLS)
Syntaxe
Syntaxe utilisant le type xlsDocument Masquer les détails
<Résultat> = xlsDonnée(<Document XLS> , <Numéro de la ligne> , <Numéro de la colonne> [, <Lignes et colonnes vides>])
<Résultat> : Chaîne de caractères - Contenu de la cellule spécifiée.
- Si le contenu de la cellule correspond à une chaîne vide (""), cela peut correspondre à une erreur. Dans ce cas, la variable ErreurDétectée est à Vrai et la fonction xlsMsgErreur renvoie le libellé de l'erreur.
<Document XLS> : Variable de type xlsDocument Nom de la variable de type xlsDocument à utiliser. <Numéro de la ligne> : Entier Numéro de la ligne de la cellule à lire. <Numéro de la colonne> : Entier Numéro de la colonne de la cellule à lire. <Lignes et colonnes vides> : Booléen optionnel Mode de prise en compte des colonnes et des lignes vides :
| | | Faux | Les lignes et les colonnes entièrement vides sont prises en compte. | Vrai
(par défaut) | Les lignes et les colonnes entièrement vides ne sont pas prises en compte. |
Syntaxe conservée par compatibilité avec la version 12 Masquer les détails
<Résultat> = xlsDonnée(<Identifiant du fichier XLS> , <Numéro de la ligne> , <Numéro de la colonne> [, <Lignes et colonnes vides>])
<Résultat> : Chaîne de caractères - Contenu de la cellule spécifiée.
- Si le contenu de la cellule correspond à une chaîne vide (""), cela peut correspondre à une erreur. Dans ce cas, la variable ErreurDétectée est à Vrai et la fonction xlsMsgErreur renvoie le libellé de l'erreur.
Remarque : Si le fichier Excel a été ouvert en mode compatible, le contenu de la cellule est limité à 255 caractères.
<Identifiant du fichier XLS> : Entier Identifiant du fichier XLS à manipuler, renvoyé par la fonction xlsOuvre. <Numéro de la ligne> : Entier Numéro de la ligne de la cellule à lire. <Numéro de la colonne> : Entier Numéro de la colonne de la cellule à lire. <Lignes et colonnes vides> : Booléen optionnel Mode de prise en compte des colonnes et des lignes vides :
| | | Faux | Les lignes et les colonnes entièrement vides sont prises en compte. | Vrai
(par défaut) | Les lignes et les colonnes entièrement vides ne sont pas prises en compte. |
Remarques Contenu des cellules : prise en compte des lignes et colonnes vides Les lignes et les colonnes vides peuvent être prises en compte ou non. Par exemple :
xlsDonnée(IDFichierXLS, 2, 3, Vrai)
xlsDonnée(IDFichierXLS, 2, 3, Faux)
Dans cet exemple, la colonne C (qui est entièrement vide) peut être prise en compte ou non. Gestion des erreurs En cas d'erreur, la fonction xlsDonnée renvoie une chaîne vide (""). Pour connaître le libellé de l'erreur, utilisez la fonction xlsMsgErreur ou la fonction ErreurInfo avec la constante errMessage. La fonction xlsDonnée génère une erreur dans les cas suivants : - La ligne et/ou la colonne spécifiée sont vides.
- Le fichier XLS spécifié n'existe pas.
- Le fichier XLS spécifié n'est pas ouvert.
Type de donnée récupérée Quel que soit le format de cellule défini sous Excel, la fonction xlsDonnée renvoie une chaîne. Attention : Le type "Numérique haute précision" n'est pas supporté par Excel : la valeur du numérique récupéré sera tronquée. | | | Si le contenu de la cellule spécifiée est de type : | Le résultat est converti en : | | Numérique | Chaîne | | Date | Chaîne au format JJ/MM/AAAA | | Heure | Chaîne au format HH:MM:SS |
Composante : wd300xls.dll
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|