Contrôler les ressources externes à l'aide des paramètres du classeur

Introduction

Dans le domaine de la manipulation et de la présentation des données, la gestion efficace des ressources externes peut changer la donne. Si vous travaillez avec des fichiers Excel et souhaitez gérer les ressources externes de manière transparente à l’aide d’Aspose.Cells pour .NET, vous êtes au bon endroit ! Dans cet article, nous allons nous plonger dans le contrôle des ressources externes lorsque vous travaillez avec des classeurs Excel. À la fin de ce guide, vous serez en mesure de mettre en œuvre une solution personnalisée pour charger des images et des données à partir de sources externes sans effort.

Prérequis

Avant de passer aux choses sérieuses du codage, vous devez respecter quelques conditions préalables. Assurez-vous de :

  1. Avoir Visual Studio : vous aurez besoin d’un IDE pour écrire et tester vos applications .NET. Visual Studio est l’option la plus recommandée en raison de son support étendu et de sa facilité d’utilisation.
  2. Téléchargez Aspose.Cells pour .NET : si vous ne l’avez pas déjà fait, récupérez la bibliothèque Aspose.Cells à partir dulien de téléchargement.
  3. Compréhension de base de C# : la familiarité avec les concepts de C# et du framework .NET rendra le processus plus fluide pour vous.
  4. Configurez votre environnement : assurez-vous que votre projet référence la bibliothèque Aspose.Cells. Vous pouvez le faire via le gestionnaire de packages NuGet dans Visual Studio.
  5. Exemples de fichiers : préparez un exemple de fichier Excel contenant une ressource externe, telle qu’une image liée. Ce fichier permettra de démontrer les fonctionnalités dont nous allons parler. Une fois que vous avez configuré ces éléments, vous êtes prêt à vous lancer dans le contrôle des ressources externes avec Aspose.Cells.

Paquets d’importation

Pour commencer à coder, vous devez importer les packages nécessaires dans votre fichier C#. Voici ce dont vous avez besoin :

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.IO;
using Aspose.Cells.Rendering;
using System.Drawing.Imaging;

Ces espaces de noms donnent accès aux fonctionnalités nécessaires à la manipulation de fichiers Excel et au traitement d’images. Décomposons-le en étapes gérables pour vous aider à contrôler les ressources externes à l’aideWorkbook SettingsNous vous expliquerons comment créer un fournisseur de flux personnalisé, charger un fichier Excel et restituer une feuille de calcul en image. N’hésitez pas à nous suivre !

Étape 1 : définir les répertoires source et de sortie

Pour commencer, nous devons spécifier les répertoires dans lesquels nous allons lire nos fichiers et où nous allons enregistrer notre sortie. Il est essentiel de définir les chemins corrects pour éviter les erreurs de fichier introuvable.

// Répertoire des sources
static string sourceDir = "Your Document Directory";
// Répertoire de sortie
static string outputDir = "Your Document Directory";

Remplacer"Your Document Directory" avec le chemin réel où se trouvent vos fichiers.

Étape 2 : implémenter l’interface IStreamProvider

Ensuite, nous allons créer une classe personnalisée qui implémente leIStreamProvider interface. Cette classe gérera la manière dont les ressources externes (comme les images) sont accessibles.

class SP : IStreamProvider
{
    public void CloseStream(StreamProviderOptions options)
    {
        // Nettoyez toutes les ressources si nécessaire
    }
    public void InitStream(StreamProviderOptions options)
    {
        // Ouvrir le flux de fichiers de la ressource externe
        FileStream fi = new FileStream(sourceDir + "sampleControlExternalResourcesUsingWorkbookSetting_StreamProvider.png", FileMode.OpenOrCreate, FileAccess.Read);
        options.Stream = fi;
    }
}

Dans leInitStream méthode, nous ouvrons le fichier qui agit comme notre ressource externe et l’affectons à laStreampropriété. Cela permet au classeur d’accéder à la ressource lors du rendu.

Étape 3 : Charger le fichier Excel

Maintenant que notre fournisseur de flux est prêt, chargeons le classeur Excel qui contient la ressource externe.

public static void Run()
{
    // Charger un exemple de fichier Excel
    Workbook wb = new Workbook(sourceDir + "sampleControlExternalResourcesUsingWorkbookSetting_StreamProvider.xlsx");
    
    // Fournissez votre implémentation de IStreamProvider
    wb.Settings.StreamProvider = new SP();

Dans cet extrait, nous chargeons notre fichier Excel et attribuons notre personnalisationStreamProvider mise en œuvre pour gérer les ressources externes.

Étape 4 : Accéder à la feuille de travail

Après avoir chargé le classeur, nous pouvons facilement accéder à la feuille de calcul souhaitée. Prenons la première.

    // Accéder à la première feuille de calcul
    Worksheet ws = wb.Worksheets[0];

C’est simple, n’est-ce pas ? Vous pouvez accéder à n’importe quelle feuille de calcul en spécifiant son index.

Étape 5 : Configurer les options d’image ou d’impression

Nous allons maintenant définir l’apparence que nous souhaitons donner à l’image de sortie. Nous allons configurer des options telles que la présence d’une page pour chaque feuille et la spécification du type d’image de sortie.

    // Spécifiez les options d'image ou d'impression
    ImageOrPrintOptions opts = new ImageOrPrintOptions();
    opts.OnePagePerSheet = true;
    opts.ImageType = Drawing.ImageType.Png;

Choisir PNG comme format de sortie garantit que la qualité reste nette et claire !

Étape 6 : Rendre la feuille de calcul sous forme d’image

Une fois tout mis en place, transformons la feuille de calcul que nous avons choisie en fichier image ! C’est la partie intéressante : vous verrez votre feuille Excel transformée en une belle image.

    // Créer un rendu de feuille en transmettant les paramètres requis
    SheetRender sr = new SheetRender(ws, opts);
    // Convertissez l'intégralité de votre feuille de calcul en image png
    sr.ToImage(0, outputDir + "outputControlExternalResourcesUsingWorkbookSetting_StreamProvider.png");
    
    Console.WriteLine("ControlExternalResourcesUsingWorkbookSetting_StreamProvider executed successfully.");
}

LeToImage La fonction effectue tout le gros du travail, en convertissant la feuille en image. Une fois cette étape terminée, vous retrouverez l’image enregistrée dans votre répertoire de sortie.

Conclusion

Et voilà ! Vous possédez désormais le savoir-faire nécessaire pour contrôler les ressources externes lorsque vous travaillez avec des fichiers Excel à l’aide d’Aspose.Cells dans .NET. Cela améliore non seulement les capacités de votre application, mais simplifie également la gestion des ensembles de données et des présentations. En suivant les étapes fournies, vous pouvez facilement reproduire et adapter cette fonctionnalité pour répondre aux besoins spécifiques de votre projet.

FAQ

Qu’est-ce qu’Aspose.Cells ?

Aspose.Cells est une bibliothèque puissante conçue pour les développeurs C# et .NET pour créer, manipuler et gérer des fichiers Excel sans avoir besoin d’installer Microsoft Excel.

Comment puis-je télécharger Aspose.Cells pour .NET ?

Vous pouvez le télécharger à partir duSite Web d’Aspose.

Existe-t-il un essai gratuit disponible ?

Oui ! Vous pouvez accéder à un essai gratuit d’Aspose.Cells à partir de leurpage de sortie.

Quels types de fichiers Aspose.Cells prend-il en charge ?

Aspose.Cells prend en charge divers formats Excel, notamment XLS, XLSX, CSV, etc.

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

Vous pouvez visiter le forum d’assistance Aspose à l’adresseForum Aspose pour obtenir de l’aide.

Rechercher le nombre maximal de lignes et de colonnes prises en charge par les formats XLS et XLSX