DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion des fichiers XLS
  • Utilisation des fonctions XLS en lecture et en écriture
  • Le fichiers XLS n'a pas pu être ouvert
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Ouvre un fichier Excel (fichiers xls ou xlsx).
Remarque : Pour créer un fichier Excel sans utiliser un fichier initial, il suffit de créer une variable de type xlsDocument (la fonction xlsOuvre est alors inutile).
Linux Seul le format xlsx est supporté.
Exemple d'ouverture de fichier Excel avec récupération d'un entier
doc est un xlsDocument
doc = xlsOuvre(fRepExe() + ["\"] + "gpac.xls")
 
SI ErreurDétectée() ALORS
Erreur(ErreurInfo())
RETOUR
FIN
 
Info("Contenu de la cellule [1,1] :", doc[1,1])
 
xlsFerme(doc)
Syntaxe
<Résultat> = xlsOuvre(<Chemin du fichier XLS> [, <Mode d'ouverture> [, <Mot de passe>]])
<Résultat> : Variable de type xlsDocument
Nom de la variable de type xlsDocument correspondant au fichier XLS. Cette variable peut être utilisée dans toutes les fonctions XLS. L'utilisation de ce type de variable permet de modifier les documents XLS.
Avertissement
Résultat compatible avec la version 12. Par compatibilité, cette variable peut être convertie en un entier correspondant à l'identifiant du fichier XLS spécifié. Cet identifiant pourra être utilisé dans toutes les fonctions XLS fonctionnant avec l'identifiant du fichier. L'utilisation de cette syntaxe avec identifiant permet uniquement de lire les documents XLS : aucune modification n'est possible.
En cas d'erreur, la variable ErreurDétectée est à Vrai et la fonction ErreurInfo permet de connaître la cause de l'erreur.
<Chemin du fichier XLS> : Chaîne de caractères
Chemin complet ou relatif du fichier XLS à ouvrir (260 caractères maximum).
<Mode d'ouverture> : Constante de type entier optionnelle
Indique le mode d'ouverture du fichier XLS.
Par défaut :
  • le fichier Excel est ouvert en lecture. Il est possible d'écrire dans le fichier Excel avec une autre application.
  • le fichier Excel utilise le mode de gestion multi-feuilles des fichiers XLS.
xlsCompatiblePermet d'ouvrir le fichier Excel en mode compatible version 10.
Dans ce mode :
  • Seule une seule feuille du classeur est gérée.
  • Unicode n'est pas géré.
  • Les regroupements de chaînes ne sont pas gérés.
  • Certaines fonctions (par exemple xlsDonnée ou xlsNbLigne) peuvent donner des résultats incohérents.
Avertissement
A partir de la version 11, cette constante est conservée par compatibilité.
xlsEcritureOuvre le fichier Excel en mode "Lecture / Ecriture" : le fichier XLS est ouvert et bloqué jusqu'à sa fermeture.
Attention : les modifications réalisées dans le fichier XLS pourront être prises en compte uniquement si vous utilisez une variable de type xlsDocument.
<Mot de passe> : Chaîne de caractères optionnelle
Mot de passe d'ouverture du fichier XLS à manipuler.
Remarques

Utilisation des fonctions XLS en lecture et en écriture

Pour manipuler les fichiers XLS en lecture et en écriture, il est nécessaire d'utiliser une variable de type xlsDocument. Ce type de variable permet également de manipuler les fichiers spécifiques à Office 2007 (fichiers .xlsx) en lecture et en écriture.
L'utilisation de l'identifiant du fichier est conservée par compatibilité avec la version 12. Les documents XLS (y compris les fichiers ".xlsx" spécifiques à Office 2007) manipulés avec cet identifiant ne pourront pas être modifiés (même si la constante xlsEcriture est spécifiée).
Exemple utilisant la syntaxe conservée par compatibilité :
IDFichierXLS est un entier
IDFichierXLS = xlsOuvre(ComplèteRep(fRepExe()) + "GPACS.XLS")
SI ErreurDétectée = Faux ALORS
Info("Le fichier XLS a été ouvert")
// Fermeture du fichier
xlsFerme(IDFichierXLS)
SINON
Info(ErreurInfo())
FIN
FIN

Le fichiers XLS n'a pas pu être ouvert

Les cas d'erreurs possibles sont les suivants :
  • Le fichier XLS spécifié n'a pas été trouvé.
  • Le fichier XLS spécifié n'existe pas.
  • Le fichier XLS spécifié ne peut pas être ouvert.
  • Le fichier XLS spécifié est invalide.
  • Pas assez de mémoire pour ouvrir le fichier XLS.
  • La version d'Excel utilisée est inconnue ou trop ancienne (les fonctions XLS ne peuvent pas lire les fichiers au format Excel version 2 ou inférieure).
Pour connaître le libellé de l'erreur, utilisez la fonction xlsMsgErreur (si vous utilisez la syntaxe compatible avec la version 12) ou la fonction ErreurInfo avec la constante errMessage.
Composante : wd290xls.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Mode d'ouverture
Bonjour,

Serait-il possible d'ajouter le mode d'ouverture xlsLectureSeule ?
Si le fichier Excel est déjà ouvert en écriture, l'ouverture du classeur n'est pas possible.

Merci.
Claude MAROLLEAU
23 juil. 2019

Dernière modification : 25/05/2022

Signaler une erreur ou faire une suggestion | Aide en ligne locale