Suivi de la progression de la conversion des documents pour TIFF par programmation dans .NET
Introduction
Vous vous lancez dans le monde de la conversion de documents ? Si vous utilisez Aspose.Cells pour .NET, vous allez vous régaler ! Cette puissante bibliothèque vous permet de gérer les fichiers Excel avec une facilité remarquable, vous permettant de convertir des feuilles de calcul en différents formats, y compris TIFF. Dans ce didacticiel, nous verrons comment suivre la progression de la conversion d’un document au fur et à mesure de son rendu en images TIFF. Imaginez que vous peignez un chef-d’œuvre, mais que vous voulez savoir comment chaque coup de pinceau contribue à l’image finale. C’est à cela que ressemble le suivi de la progression de la conversion ! Dans cet article, nous allons détailler le processus étape par étape, en veillant à ce que vous compreniez parfaitement chaque élément. Que vous soyez un développeur expérimenté ou que vous débutiez, vous trouverez des informations utiles et des extraits de code pratiques pour améliorer vos compétences en matière de gestion de documents. Alors, retroussons nos manches et plongeons dans le monde d’Aspose.Cells !
Prérequis
Avant de nous lancer dans le plaisir du codage, assurons-nous que tout est en place. Voici ce dont vous aurez besoin pour commencer :
- Visual Studio : assurez-vous que Visual Studio est installé sur votre ordinateur. C’est ici que vous écrirez et testerez votre code.
- Aspose.Cells pour .NET : vous devez télécharger et installer la bibliothèque Aspose.Cells. Vous pouvez obtenir la dernière versionici.
- Connaissances de base de C# : une compréhension fondamentale de la programmation C# vous aidera à naviguer en douceur dans le code. Une fois ces prérequis définis, vous êtes prêt à plonger dans le monde de la conversion de documents !
Paquets d’importation
Avant de pouvoir commencer à coder, nous devons importer les packages nécessaires. Voici comment procéder :
- Ouvrez Visual Studio et créez un nouveau projet d’application console.
- Installez Aspose.Cells via le gestionnaire de packages NuGet. Pour ce faire, cliquez avec le bouton droit de la souris sur votre projet dans l’Explorateur de solutions, sélectionnez Gérer les packages NuGet et recherchez Aspose.Cells. Cliquez sur Installer pour l’ajouter à votre projet. Une fois la bibliothèque installée, vous devrez ajouter les directives d’utilisation appropriées en haut de votre fichier C# :
using Aspose.Cells.Drawing;
using Aspose.Cells.Rendering;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
Passons maintenant à la partie intéressante : le guide étape par étape pour suivre la progression de la conversion des documents !
Étape 1 : Configurer les répertoires source et de sortie
Pour commencer, nous devons définir l’emplacement de notre document source et l’emplacement où nous souhaitons que les fichiers TIFF de sortie soient enregistrés. Voici comment vous pouvez le configurer :
// Répertoire des sources
string sourceDir = "Your Document Directory";
// Répertoire de sortie
string outputDir = "Your Document Directory";
Assurez-vous de remplacer"Your Document Directory" avec le chemin réel où votre fichier Excel est stocké et où vous souhaitez enregistrer les fichiers TIFF.
Étape 2 : charger le classeur
Maintenant, chargeons le classeur Excel que nous voulons convertir. Aspose.Cells rend cette opération très simple ! Voici comment procéder :
Workbook workbook = new Workbook(sourceDir + "sampleUseWorkbookRenderForImageConversion.xlsx");
Dans cette ligne, remplacez"sampleUseWorkbookRenderForImageConversion.xlsx" avec le nom de votre fichier Excel. Cette ligne initialise leWorkbookobjet qui représente votre feuille de calcul en mémoire.
Étape 3 : Créer une image ou des options d’impression
Ensuite, nous devons configurer les options de rendu de notre classeur au format TIFF. C’est ici que nous pouvons spécifier divers paramètres, y compris notre rappel de sauvegarde de page personnalisé :
ImageOrPrintOptions opts = new ImageOrPrintOptions();
opts.PageSavingCallback = new TestTiffPageSavingCallback();
opts.ImageType = ImageType.Tiff;
Ici, nous créons une instance deImageOrPrintOptions et en lui disant que nous voulons utiliser notre classe de rappel personnalisée,TestTiffPageSavingCallback, pour suivre la progression. Nous spécifions également que nous voulons que le type d’image de sortie soit TIFF.
Étape 4 : implémenter le rappel d’enregistrement de page
Le cœur du suivi de la progression de la conversion réside dans la mise en œuvre de laIPageSavingCallback interface. C’est ici que vous définissez ce qui se passe lorsque chaque page commence et termine l’enregistrement. Voici comment configurer cela :
public class TestTiffPageSavingCallback : IPageSavingCallback
{
public void PageStartSaving(PageStartSavingArgs args)
{
Console.WriteLine("Start saving page index {0} of pages {1}", args.PageIndex, args.PageCount);
// Ne pas afficher les pages avant l'index de page 2.
if (args.PageIndex < 2)
{
args.IsToOutput = false;
}
}
public void PageEndSaving(PageEndSavingArgs args)
{
Console.WriteLine("End saving page index {0} of pages {1}", args.PageIndex, args.PageCount);
// Ne pas afficher les pages après l'index de page 8.
if (args.PageIndex >= 8)
{
args.HasMorePages = false;
}
}
}
Dans lePageStartSaving méthode, nous enregistrons l’index de la page et le nombre total de pages avant le début de l’enregistrement. De plus, vous pouvez contrôler les pages à afficher. Dans ce cas, nous ignorons les pages avant l’index 2. De même, dans la méthodePageEndSavingméthode, nous enregistrons lorsqu’une page termine d’être enregistrée, et nous pouvons également empêcher l’enregistrement de nouvelles pages après l’index 8.
Étape 5 : Rendre le classeur en images
Maintenant que nos options sont configurées et que notre fonction de rappel est implémentée, nous sommes prêts à afficher le classeur ! Voici comment procéder :
WorkbookRender wr = new WorkbookRender(workbook, opts);
wr.ToImage(outputDir + "DocumentConversionProgressForTiff_out.tiff");
Cette ligne crée une instance deWorkbookRender , en passant dans notreworkbook et les options que nous avons définies précédemment. Nous appelons ensuiteToImage, spécifiant le chemin de sortie de notre fichier TIFF.
Étape 6 : Message de réussite
Enfin, nous allons vous donner notre avis sur la réussite de notre conversion. C’est toujours agréable d’avoir une confirmation, n’est-ce pas ?
Console.WriteLine("DocumentConversionProgressForTiff executed successfully.");
Cela imprimera un message de réussite sur la console, vous indiquant que tout s’est déroulé comme prévu.
Conclusion
Félicitations ! Vous venez d’apprendre à suivre la progression de la conversion de documents pour les images TIFF à l’aide d’Aspose.Cells pour .NET. En suivant ces étapes, vous pouvez facilement gérer la conversion de documents Excel et obtenir des informations sur chaque étape du processus. Cette fonctionnalité est particulièrement utile pour les documents volumineux pour lesquels vous souhaitez surveiller la progression ou contrôler la sortie de pages spécifiques. N’hésitez pas à expérimenter avec le code et à le personnaliser davantage pour l’adapter à vos besoins. Bon codage !
FAQ
Qu’est-ce qu’Aspose.Cells ?
Aspose.Cells est une bibliothèque .NET qui vous permet de manipuler des fichiers Excel par programmation, prenant en charge une large gamme de formats et de fonctionnalités.
Puis-je suivre la progression de la conversion pour d’autres formats ?
Oui ! Le mécanisme de rappel peut également être adapté à d’autres formats comme PDF ou JPEG.
Ai-je besoin d’une licence pour utiliser Aspose.Cells ?
Bien que vous puissiez l’essayer gratuitement, une licence est requise pour bénéficier de toutes les fonctionnalités en production. Vous trouverez plus d’informationsici.
Où puis-je obtenir de l’aide si je rencontre des problèmes ?
Vous pouvez visiter leForum d’assistance Asposepour l’aide de la communauté et de l’équipe Aspose.
Comment démarrer avec Aspose.Cells ?
Vous pouvez télécharger la bibliothèque et consulter ledocumentation pour des tutoriels et des exemples.
