PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • 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/iPadApple WatchUniversal Windows 10 AppWindows Mobile
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).
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.
Linux Seul le format xlsx est supporté.
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.
Linux Seul le format xlsx est supporté.
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.
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> : Entier ou 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.
  • Identifiant du fichier XLS spécifié. Cet identifiant sera utilisé dans toutes les fonctions XLS. Syntaxe conservée par compatibilité avec la version 12. 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 en utilisant le mode de gestion multi-feuilles des fichiers XLS.
xlsEcriture
(Valeur par défaut)
Ouvre 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.
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é.
<Mot de passe> : Chaîne de caractères (avec guillemets) optionnelle
Versions 24 et supérieures
Mot de passe d'ouverture du fichier XLS à manipuler.
Nouveauté 24
Mot de passe d'ouverture du fichier XLS à manipuler.
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 : wd240xls.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire