Как настроить Excel для рендеринга изображений в C#

Когда вы экспортируете листы Excel или диапазоны в изображения, вам часто нужно точно контролировать, как выглядит содержимое. Будь то для печати, презентации или встраивания, эта статья демонстрирует, как настроить рендеринг изображений с помощью Aspose.Cells для .NET.

Почему настраивать рендеринг?

Улучшить четкость и разрешение изображения
Показать или скрыть сетку, формулы или заголовки
Соответствовать макету и размерам требованиям документации
Отрегулировать прозрачность фона или границы

Пошаговое руководство

Шаг 1: Установите Aspose.Cells для .NET

dotnet add package Aspose.Cells

Шаг 2: Загрузите книгу и лист

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

Шаг 3: Настройте расширенные параметры рендеринга

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

Шаг 4: Включите сетку и заголовки (по желанию)

// Показать сетку в выходных данных
options.ShowGridLines = true;

// Отобразить заголовки строк/столбцов
options.ShowRowColumnHeaders = true;

Шаг 5: Настройте параметры страницы

// Установите рендеринг всего листа на одной странице
options.AllColumnsInOnePagePerSheet = true;
options.AllRowsInOnePagePerSheet = true;

Шаг 6: Рендеринг в изображение с помощью SheetRender

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

Шаг 7: Сохраните и проверьте выходные данные

Убедитесь, что полученное изображение отражает ваш индивидуальный макет и визуальные предпочтения.

Полный пример кода

using System;
using Aspose.Cells;

class Program
{
    static void Main()
    {
        // Загрузите файл Excel
        Workbook workbook = new Workbook("Template.xlsx");
        Worksheet worksheet = workbook.Worksheets["Sheet1"];

        // Настройте параметры расширенного рендеринга
        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
        };

        // Рендеринг в изображение
        SheetRender renderer = new SheetRender(worksheet, options);
        renderer.ToImage(0, "custom_output.png");

        Console.WriteLine("Лист с индивидуальным рендерингом сохранен как изображение.");
    }
}

Советы для лучшего контроля

Настройка	Описание
`ImageType`	Выберите PNG, JPEG, BMP или TIFF
`Transparent`	Установите true для прозрачного фона
`SmoothingMode`	Улучшите визуальные эффекты с помощью сглаживания
`ShowFormulas`	Показать формулы вместо вычисленных значений
`ChartImageWidth` / `ChartImageHeight`	Установите размер выходных данных для графиков