Comment personnaliser Excel pour le rendu d'images en C#

Lorsque vous exportez des feuilles de calcul Excel ou des plages vers des images, vous avez souvent besoin d’un contrôle précis sur l’apparence du contenu. Que ce soit pour l’impression, la présentation ou l’intégration, cet article démontre comment personnaliser le rendu des images en utilisant Aspose.Cells for .NET.

Pourquoi personnaliser le rendu ?

Améliorer la clarté et la résolution de l’image
Afficher ou masquer les lignes de grille, les formules ou les en-têtes
Adapter la mise en page et la taille aux exigences de documentation
Ajuster la transparence de l’arrière-plan ou des bordures

Guide étape par étape

Étape 1 : Installer Aspose.Cells for .NET

dotnet add package Aspose.Cells

Étape 2 : Charger le classeur et la feuille de calcul

Workbook workbook = new Workbook("Template.xlsx");
Worksheet worksheet = workbook.Worksheets["Sheet1"];

Étape 3 : Configurer les options de rendu avancées

ImageOrPrintOptions options = new ImageOrPrintOptions
{
    ImageType = ImageType.Png,
    HorizontalResolution = 300,
    VerticalResolution = 300,
    PrintWithStatusDialog = false,
    Transparent = false,
    OnePagePerSheet = true
};

Étape 4 : Activer les lignes de grille et les en-têtes (facultatif)

// Afficher les lignes de grille dans la sortie
options.ShowGridLines = true;

// Rendre les en-têtes de lignes/colonnes
options.ShowRowColumnHeaders = true;

Étape 5 : Personnaliser les paramètres de page

// Définir pour rendre l'ensemble de la feuille comme une seule page
options.AllColumnsInOnePagePerSheet = true;
options.AllRowsInOnePagePerSheet = true;

Étape 6 : Rendre l’image avec SheetRender

SheetRender renderer = new SheetRender(worksheet, options);
renderer.ToImage(0, "custom_output.png");

Étape 7 : Sauvegarder et vérifier la sortie

Assurez-vous que l’image résultante reflète votre mise en page et vos choix visuels personnalisés.

Exemple de code complet

using System;
using Aspose.Cells;

class Program
{
    static void Main()
    {
        // Charger le fichier Excel
        Workbook workbook = new Workbook("Template.xlsx");
        Worksheet worksheet = workbook.Worksheets["Sheet1"];

        // Configurer les options de rendu avancées
        ImageOrPrintOptions options = new ImageOrPrintOptions
        {
            ImageType = ImageType.Png,
            HorizontalResolution = 300,
            VerticalResolution = 300,
            PrintWithStatusDialog = false,
            Transparent = false,
            OnePagePerSheet = true,
            ShowGridLines = true,
            ShowRowColumnHeaders = true,
            AllColumnsInOnePagePerSheet = true,
            AllRowsInOnePagePerSheet = true
        };

        // Rendre en image
        SheetRender renderer = new SheetRender(worksheet, options);
        renderer.ToImage(0, "custom_output.png");

        Console.WriteLine("Feuille de calcul rendue sur mesure enregistrée en tant qu'image.");
    }
}

Conseils pour un meilleur contrôle

Paramètre	Description
`ImageType`	Choisissez PNG, JPEG, BMP ou TIFF
`Transparent`	Définir vrai pour un arrière-plan transparent
`SmoothingMode`	Améliorer les visuels en utilisant l’anticrénelage
`ShowFormulas`	Afficher les formules au lieu des valeurs calculées
`ChartImageWidth` / `ChartImageHeight`	Définir la taille de sortie pour les graphiques