Como Personalizar o Renderização de Imagem do Excel em C#

Ao exportar folhas de trabalho do Excel ou variar para imagens, muitas vezes você precisa de controle preciso sobre como o conteúdo parece. Seja para impressão, apresentação ou inserção, este artigo mostra como personalizar a renderização de imagem usando Aspose.Cells para .NET.

Por que o Customize Rendering?

Melhorar a clareza e resolução da imagem
Mostrar ou esconder linhas, fórmulas ou títulos
Compatível com layout e tamanho para os requisitos de documentação
Ajuste a transparência de fundo ou fronteiras

Guia passo a passo

Passo 1: Instalar Aspose.Cells para .NET

dotnet add package Aspose.Cells

Passo 2: Carregar o livro de trabalho e folheto de trabalho

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

Passo 3: Configurar opções de renderização avançadas

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

Passo 4: Ativar linhas de rede e cabeçalhos (opcional)

// Show gridlines in the output
options.ShowGridLines = true;

// Render row/column headings
options.ShowRowColumnHeaders = true;

Passo 5: Personalizar as configurações da página

// Set to render entire sheet as a single page
options.AllColumnsInOnePagePerSheet = true;
options.AllRowsInOnePagePerSheet = true;

Passo 6: Render para imagem com SheetRender

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

Passo 7: Salve e Verifique a saída

Certifique-se de que a imagem resultante reflete seu layout personalizado e escolhas visuais.

Código de Exemplo Completo

using System;
using Aspose.Cells;

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

        // Set up advanced rendering options
        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
        };

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

        Console.WriteLine("Custom-rendered worksheet saved as image.");
    }
}

Dicas para um melhor controle

Estabelecimento	Descrição
`ImageType`	Escolha PNG, JPEG, BMP ou TIFF
`Transparent`	Definir verdadeiro para um fundo transparente
`SmoothingMode`	Melhorar a visão usando anti-alias
`ShowFormulas`	Mostrar fórmulas em vez de valores calculados
`ChartImageWidth` / `ChartImageHeight`	Configuração de tamanho de saída para gráficos