DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions Tableur
WINDEV
WindowsLinuxJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac Catalyst
Autres
Procédures stockées
Sauve le contenu d'un champ Tableur dans un fichier. Les formats supportés sont :
  • XLSX (classeur Excel),
  • XLSM (classeur Excel prenant en charge les macros),
  • XLTX (modèle Excel),
  • XLTM (modèle Excel prenant en charge les macros),
  • Nouveauté 2025
    CSV (fichier csv).
Exemple
// Sauvegarde du fichier en cours
TBLR_Tableur.Sauve("Classeur1.XLSX")
// Chargement du fichier
TBLR_SansNom1.Charge("test.xlsx")
// Modification du fichier
TBLR_SansNom1["A","1"] = "modifié"
// Sauvegarde sous un autre nom
// Le fichier "text1.xlsx" existe déjà
SI TBLR_SansNom1.Sauve("test1.xlsx") = Faux ALORS
	// Avant la version 200051, le fichier xlsx existant est écrasé. 
	// A partir de la version 200051, le fichier xlsx existant n'est pas modifié. 
	// La fonction renvoie Faux et une erreur 
	// Pour écraser le fichier, utilisez la constante tblrEcrasementAutorisé
	Erreur("Fichier non sauvegardé " + ErreurInfo()
SINON
	Info("Fichier sauvegardé")
FIN
Syntaxe
<Résultat> = <Champ Tableur>.Sauve(<Fichier à sauver> [, <Option> [, <Mot de passe>]])
<Résultat> : Booléen
  • Vrai si le fichier du champ Tableur a été sauvé,
  • Faux dans le cas contraire. La fonction ErreurInfo permet d'obtenir plus de détails sur l'erreur.
<Champ Tableur> : Nom de champ
Nom du champ Tableur à manipuler.
<Fichier à sauver> : Chaîne de caractères
Nom et chemin complet du fichier dans lequel le contenu du champ Tableur sera sauvé. L'extension du fichier permet de définir le format de sauvegarde. Les formats supportés sont :
  • XLSX (classeur Excel),
  • XLSM (classeur Excel prenant en charge les macros),
  • XLTX (modèle Excel),
  • XLTM (modèle Excel prenant en charge les macros),
  • Nouveauté 2025
    CSV (fichier csv).
    Remarque : seule la feuille en cours est sauvée. Seule la valeur des cellules est sauvée (les formules par exemple ne sont pas sauvées, seul le résultat affiché de la formule est sauvé).
<Option> : Constante optionnelle de type Entier
Mode d'enregistrement du fichier si le fichier existe déjà :
0 (ou rien)
(Comportement par défaut)
Si le fichier XLSX existe déjà et n'est pas ouvert (dans le champ Tableur ou une autre application), il n'est pas sauvé.
tblrEcrasementAutoriséSi le fichier XLSX existe déjà et n'est pas ouvert (dans le champ Tableur ou une autre application), il est écrasé.
<Mot de passe> : Chaîne de caractères optionnelle ou Chaîne secrète
Mot de passe à utiliser pour protéger le fichier XLSX en ouverture. Ce mot de passe devra être indiqué pour ouvrir le fichier XLSX.
Nouveauté 2025
Utilisation de chaînes secrètes : Si vous utilisez le coffre-fort de chaînes secrètes, le type de la chaîne secrète utilisable pour ce paramètre doit être "Chaîne Ansi ou Unicode".
Pour plus de détails sur les chaînes secrètes et l'utilisation du coffre-fort, consultez Coffre-fort de chaînes secrètes.
Remarques
  • Pour ouvrir le fichier ".xlsx" sauvé avec une autre application, il est nécessaire de le fermer avec la fonction <Tableur>.Ferme.
  • Le fichier sauvé pourra être rechargé dans un champ Tableur grâce aux fonctions <Tableur>.Charge et xlsOuvre.
  • Cette fonction est utilisable uniquement sur un champ Tableur présent dans une fenêtre.
  • La fonction <Tableur>.Sauve met à jour la propriété CheminFichier du champ Tableur en associant le nom du fichier chargé au champ Tableur.
Liste des exemples associés :
Le champ Tableur Exemples unitaires (WINDEV) : Le champ Tableur
[ + ] Utilisation du champ Tableur.
Cet exemple présente comment :
- charger un fichier xlsx dans un champ tableur,
- sauver le tableur dans un fichier,
- remplir le champ avec des données provenant de la base de données,
- insérer des lignes, des colonnes,
- accéder aux cellules et les manipuler (modifier leur valeur, leur style,...),
- saisir des formules,
- etc.
Classification Métier / UI : Code UI
Composante : wd300obj.dll
Version minimum requise
  • Version 23
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 06/11/2024

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