PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • Contenu des cellules : prise en compte des lignes et colonnes vides
  • Gestion des erreurs
  • Type de donnée récupérée
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
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.
Les performances de cette fonction ont été améliorées en version 14.
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.
Versions 16 et supérieures
WINDEVLinux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
WEBDEV - Code ServeurLinux Cette fonction est désormais disponible pour les sites WEBDEV sous Linux.
Nouveauté 16
WINDEVLinux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
WEBDEV - Code ServeurLinux Cette fonction est désormais disponible pour les sites WEBDEV sous Linux.
WINDEVLinux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
WEBDEV - Code ServeurLinux Cette fonction est désormais disponible pour les sites WEBDEV sous Linux.
// Déclaration des variables
ResDonnée est une chaîne
IDFichierXLS est un entier

// Ouverture d'un fichier XLS
IDFichierXLS = xlsOuvre("C:\MonRépertoire\Fichier.XLS")
SI IDFichierXLS <> -1 ALORS
// Récupération de la valeur d'une cellule
ResDonnée = xlsDonnée(IDFichierXLS, 3, 4)
...
FIN
cMonFicXLS est 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)
// Changement de feuille
SI xlsFeuilleEnCours(cMonFicXLS, 2) = Vrai ALORS
Info("La feuille courante a été modifiée.")
// Lecture d'une cellule pour test
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 :
Vrai
(par défaut)
Les lignes et les colonnes entièrement vides ne sont pas prises en compte.
FauxLes lignes et les colonnes entièrement vides sont 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 :
Vrai
(par défaut)
Les lignes et les colonnes entièrement vides ne sont pas prises en compte.
FauxLes lignes et les colonnes entièrement vides sont 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)
// Retourne le contenu de la cellule D2 : "23"
xlsDonnée(IDFichierXLS, 2, 3, Faux)
// Retourne le contenu de la cellule C2 : ""
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ériqueChaîne
DateChaîne au format JJ/MM/AAAA
HeureChaîne au format HH:MM:SS
Composante : wd240xls.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire