Suivi de la progression de la conversion des documents par programmation dans .NET

Introduction

Vous cherchez à améliorer votre processus de conversion de documents à l’aide d’Aspose.Cells pour .NET ? Si tel est le cas, vous êtes au bon endroit ! Dans ce tutoriel, nous allons nous plonger dans le suivi de la progression de la conversion des documents Excel au fur et à mesure de leur transformation au format PDF. Non seulement nous vous guiderons à travers les étapes essentielles pour y parvenir, mais nous vous fournirons également quelques informations utiles tout au long du processus. Alors, commençons !

Prérequis

Avant de passer aux détails du suivi de la conversion des documents, vous devez mettre en place quelques conditions préalables :

  1. Connaissances de base de C# : Étant donné que nous utiliserons C# pour coder, une compréhension fondamentale de ce langage de programmation sera utile.
  2. Visual Studio installé : il servira d’environnement de développement. Vous pouvez utiliser la version de votre choix, mais la plus récente est toujours un bon choix.
  3. Aspose.Cells pour .NET : assurez-vous d’avoir installé Aspose.Cells. Vous pouvez le télécharger à partir duSite Web d’Aspose.
  4. Un fichier Excel : Préparez un exemple de fichier Excel pour la conversion. Vous pouvez créer un fichier Excel simple.xlsx dossier à suivre.

Paquets d’importation

Maintenant que nous avons couvert nos prérequis, il est temps d’importer les packages nécessaires à votre projet C#. Voici comment procéder :

Créer un nouveau projet

  1. Ouvrez Visual Studio et créez un nouveau projet. Choisissez un modèle d’application console pour plus de simplicité.

Ajouter une référence à Aspose.Cells

  1. Cliquez avec le bouton droit sur les références dans l’Explorateur de solutions, sélectionnez Ajouter une référence et accédez à l’assembly Aspose.Cells s’il n’est pas ajouté automatiquement. Vous pouvez également utiliser le gestionnaire de packages NuGet en exécutant la commande suivante dans la console du gestionnaire de packages :
Install-Package Aspose.Cells

Importer des espaces de noms

  1. Au sommet de votreProgram.cs fichier, ajoutez la directive using suivante :
using Aspose.Cells.Rendering;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

Nous sommes maintenant tous prêts avec la configuration de notre projet !

Une fois les bases posées, décomposons le processus réel de suivi de la conversion des documents en étapes digestes.

Étape 1 : Définissez vos répertoires

Commencez par spécifier les répertoires dans lesquels vos fichiers source et de sortie résideront. Voici comment procéder :

// 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 d’accès réel sur votre système. Cela vous aidera à localiser facilement vos fichiers.

Étape 2 : charger le classeur

Ensuite, vous devez charger votre classeur Excel à l’aide de l’Workbook classe. Voici comment :

Workbook workbook = new Workbook(sourceDir + "PagesBook1.xlsx");

Cette ligne de code crée unWorkbook objet qui nous permettra d’interagir avec le fichier Excel que nous avons spécifié.

Étape 3 : Configurer les options d’enregistrement PDF

Maintenant, configurons les options d’enregistrement PDF. C’est là que commence la magie du suivi de la progression. Vous allez créer une instance dePdfSaveOptions et lui attribuer un rappel.

PdfSaveOptions pdfSaveOptions = new PdfSaveOptions();
pdfSaveOptions.PageSavingCallback = new TestPageSavingCallback();

En attribuant un rappel personnalisé (TestPageSavingCallback), nous pouvons implémenter notre propre logique pour suivre la progression de la conversion des pages.

Étape 4 : Enregistrer le classeur au format PDF

Une fois tout configuré, il est temps d’enregistrer votre classeur au format PDF. Utilisez leSave méthode de laWorkbook classe comme ça :

workbook.Save(outputDir + "DocumentConversionProgress.pdf", pdfSaveOptions);

Cette ligne déclenchera le processus de conversion et appellera nos méthodes de rappel pendant que les pages sont en cours de traitement.

Étape 5 : implémenter la classe de rappel

Créons maintenant leTestPageSavingCallback classe. C’est ici que vous définissez ce qui se passe au début et à la fin de l’enregistrement de chaque page.

public class TestPageSavingCallback : 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;
        }
    }
}
  • PageStartSavingCette méthode est appelée juste avant qu’une page ne commence à être enregistrée. Ici, nous enregistrons le début du processus d’enregistrement pour chaque page. De plus, nous pouvons contrôler si la page doit être affichée ou non. Dans ce cas, les pages avant l’index 2 sont ignorées.
  • PageEndSaving: Cette méthode est invoquée après l’enregistrement d’une page. Elle vous permet d’enregistrer la fin de l’enregistrement de chaque page et de contrôler si davantage de pages doivent être traitées. Dans cet exemple, nous nous arrêtons après l’index de page 8.

Conclusion

Félicitations ! Vous avez implémenté avec succès un système permettant de suivre la progression de la conversion de documents à l’aide d’Aspose.Cells pour .NET. Cette approche vous permet non seulement de surveiller le processus de conversion, mais également de contrôler les pages à inclure ou à exclure, ce qui rend la gestion de vos documents beaucoup plus efficace.

FAQ

Qu’est-ce qu’Aspose.Cells ?

Aspose.Cells est une puissante bibliothèque .NET qui permet aux développeurs de créer, manipuler et convertir des fichiers Excel par programmation.

Comment puis-je obtenir un essai gratuit d’Aspose.Cells ?

Vous pouvez télécharger une version d’essai gratuite à partir duSite Web d’Aspose.

Est-il possible de personnaliser le processus de conversion ?

Oui, en utilisant des rappels, vous pouvez personnaliser la manière dont les pages sont traitées pendant la conversion.

Puis-je contrôler le nom du fichier de sortie ?

Absolument ! Vous pouvez spécifier n’importe quel nom pour votre fichier de sortie lors de l’enregistrement du classeur.

Où puis-je trouver du support pour Aspose.Cells ?

Vous pouvez obtenir de l’aide en visitant leForum Aspose.

Enregistrement d'un classeur au format de feuille de calcul Open XML strict dans .NET Suivi de la progression de la conversion des documents pour TIFF par programmation dans .NET