当谈到将 Excel 内容转化为高品质的图像时, Aspose.Cells for .NET 表现为一个强大的解决方案. 无论您需要将整个工作簿、特定工作表、图表甚至个单元格转换,这个全面的指南将为您提供所有你需要知道的信息 Aspose.Cells 图像转换器.

内容表

引入

Aspose.Cells Image Converter for .NET 允许开发人员将 Excel 内容转换为各种图像格式,如 PNG、JPEG、BMP 等,具有完美的像素准确性:

  • 创建视觉预览的分布板
  • 创建报告小组
  • 将 Excel 数据嵌入到 Web 应用中
  • 存档广播图视觉
  • 创建Dashboard组件
  • 转换图表为演示

主要特点

Aspose.Cells 图像转换器提供多种强大的功能:

  • 多元化转换选项:转换整个工作簿、个别工作表、特定序列或内置图表.
  • 高度可自定义的转换:控制分辨率、规模、网线、透明度等,使用 ImageOrPrintOptions 班级.
  • 多格式支持:出口到PNG、JPEG、BMP、TIFF和其他流行的图像格式.
  • 支持所有 Excel 格式:使用 XLS、XLSX、XLSM、XLSB、XLTX、XLTM、CSV、TSV、HTML、ODS 等.
  • Advanced Rendering Control:使用专门的Renderers如 SheetRender 或 WorkbookRender 优化产量.
  • Seamless .NET Integration: 使用 .NET Framework 和 .NET Core 应用程序.

开始使用

要开始使用 Aspose.Cells 图像转换器,首先将 Aspose.Cells 包添加到您的 .NET 项目中:

dotnet add package Aspose.Cells

接下来,将所需的名称空间添加到您的代码:

using Aspose.Cells;
using Aspose.Cells.Rendering;

图像转换的基本工作流包括:

  • 加载工作簿
  • 设置图像选项
  • 创建一个Render
  • 导出到图像文件

让我们看看一个简单的例子,将工作表转换为PNG图像:

// Load the Excel file
Workbook workbook = new Workbook("Sample.xlsx");
Worksheet worksheet = workbook.Worksheets[0];

// Configure image options
ImageOrPrintOptions options = new ImageOrPrintOptions
{
    ImageType = ImageType.Png,
    HorizontalResolution = 200,
    VerticalResolution = 200,
    OnePagePerSheet = true
};

// Create renderer and export
SheetRender renderer = new SheetRender(worksheet, options);
renderer.ToImage(0, "output_image.png");

现在,让我们详细探索更具体的场景.

将工作表转换为图像

将特定工作表转换为图像是最常见的任务之一,这特别有用于创建视觉报告或预览.

Workbook workbook = new Workbook("SalesData.xlsx");
Worksheet sheet = workbook.Worksheets["Q1 Report"]; // Access by name

ImageOrPrintOptions options = new ImageOrPrintOptions
{
    ImageType = ImageType.Png,
    OnePagePerSheet = true,
    HorizontalResolution = 200,
    VerticalResolution = 200
};

SheetRender renderer = new SheetRender(sheet, options);

// Export each page (if worksheet spans multiple pages)
for (int pageIndex = 0; pageIndex < renderer.PageCount; pageIndex++)
{
    string imageName = $"worksheet_page_{pageIndex + 1}.png";
    renderer.ToImage(pageIndex, imageName);
}

要将整个工作表放在一个单一的图像上,您可以使用以下选项:

options.AllColumnsInOnePagePerSheet = true;
options.AllRowsInOnePagePerSheet = true;

转换一个完整的工作簿

对于多页工作簿,您可能希望将整个文件转换为一系列图像,这对存档或创建全面预览有用.

Workbook workbook = new Workbook("FinancialReport.xlsx");

ImageOrPrintOptions options = new ImageOrPrintOptions
{
    ImageType = ImageType.Png,
    OnePagePerSheet = true,
    HorizontalResolution = 200,
    VerticalResolution = 200
};

// Use WorkbookRender for whole workbook
WorkbookRender renderer = new WorkbookRender(workbook, options);

for (int i = 0; i < renderer.PageCount; i++)
{
    string fileName = $"workbook_page_{i + 1}.png";
    renderer.ToImage(i, fileName);
}

出口 Excel 图表

图表提供强大的数据视觉代表性. 将 Excel 图表转换为单独的图像,适合演示文稿、报告或网页内容.

Workbook workbook = new Workbook("Dashboard.xlsx");
Worksheet sheet = workbook.Worksheets["Charts"];

// Access the first chart
Chart chart = sheet.Charts[0];

// Configure chart image options
ImageOrPrintOptions options = new ImageOrPrintOptions
{
    ImageType = ImageType.Png,
    HorizontalResolution = 300,
    VerticalResolution = 300,
    SmoothingMode = SmoothingMode.AntiAlias,
    ChartImageWidth = 1200,
    ChartImageHeight = 800
};

// Export chart directly to image
chart.ToImage("chart_output.png", options);

与 Cell Ranges 合作

有时你只需要出口一个特定的细胞范围,而不是整个工作表,这对出口价格表、产品目录或特定数据子组有用.

Workbook workbook = new Workbook("DataSet.xlsx");
Worksheet worksheet = workbook.Worksheets[0];

// Define the range to export (A1 to D10)
Range range = worksheet.Cells.CreateRange("A1", "D10");

// Set the print area to this range
worksheet.PageSetup.PrintArea = range.RefersTo;

// Configure image options
ImageOrPrintOptions options = new ImageOrPrintOptions
{
    ImageType = ImageType.Png,
    HorizontalResolution = 200,
    VerticalResolution = 200,
    OnePagePerSheet = true
};

// Render only the specified range
SheetRender renderer = new SheetRender(worksheet, options);
renderer.ToImage(0, "range_output.png");

单细胞转换

对于非常专注的出口,你甚至可以将单个细胞转换为一个图像,这是一个完美的隔离关键测量,价格或标签.

Workbook workbook = new Workbook("KPIReport.xlsx");
Worksheet sheet = workbook.Worksheets[0];

// Select a single cell
Cell cell = sheet.Cells["B5"];

// Set print area to just that cell
sheet.PageSetup.PrintArea = "B5";

// Configure image options
ImageOrPrintOptions options = new ImageOrPrintOptions
{
    ImageType = ImageType.Png,
    OnePagePerSheet = true,
    HorizontalResolution = 300,
    VerticalResolution = 300
};

// Render and save
SheetRender renderer = new SheetRender(sheet, options);
renderer.ToImage(0, "cell_b5_output.png");

创建Tumbnails

图标提供快速的 Excel 内容视觉预览,适合文档画廊或文件浏览界面.

using System;
using System.Drawing;
using Aspose.Cells;

// Load Excel file
Workbook workbook = new Workbook("Report.xlsx");
Worksheet sheet = workbook.Worksheets[0];

// Configure low-resolution options for initial render
ImageOrPrintOptions options = new ImageOrPrintOptions
{
    ImageType = ImageType.Png,
    HorizontalResolution = 96,
    VerticalResolution = 96,
    OnePagePerSheet = true
};

// Render full sheet as a temporary image
SheetRender renderer = new SheetRender(sheet, options);
renderer.ToImage(0, "preview_temp.png");

// Resize to thumbnail dimensions
using (Bitmap original = new Bitmap("preview_temp.png"))
{
    Bitmap thumbnail = new Bitmap(original, new Size(160, 120));
    thumbnail.Save("thumbnail.png");
}

透明背景图像

当将 Excel 视觉集成到设计或上层时,透明背景是必不可少的:

Workbook workbook = new Workbook("DataGrid.xlsx");
Worksheet sheet = workbook.Worksheets[0];

// Hide gridlines and headings
sheet.PageSetup.PrintGridlines = false;
sheet.PageSetup.PrintHeadings = false;
sheet.DisplayGridlines = false;

// Set image rendering options with transparency enabled
ImageOrPrintOptions options = new ImageOrPrintOptions
{
    ImageType = ImageType.Png,
    Transparent = true,
    OnePagePerSheet = true
};

// Render the sheet as an image
SheetRender renderer = new SheetRender(sheet, options);
renderer.ToImage(0, "transparent_output.png");

注意:只有 PNG 格式支持透明度.

定制图像转换

Aspose.Cells 为图像呈现提供广泛的定制选项,允许您控制几乎每个输出方面:

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
};

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

下面是最有用的定制特性:

财产描述
ImageType设置输出格式(PNG、JPEG、BMP等.)
HorizontalResolution / VerticalResolution图像控制 DPI
OnePagePerSheet将每个页面作为一个单一的图像
ShowGridLinesToggles 网路可见性
ShowRowColumnHeaders显示或隐藏序列和列头
Transparent可透明背景(仅限PNG)
SmoothingMode防滑控制,以便更顺利的线条
PrintingPageType检查哪些内容要包含

最佳实践

要在将 Excel 转换为图像时获得最佳结果,请遵循以下建议:

  • 自定义列在播放前 以确保所有内容可见:
worksheet.AutoFitColumns();
  • 印刷或高DPI输出的增强分辨率:
options.HorizontalResolution = 300;
options.VerticalResolution = 300;
  • 使用白色背景用于更清洁的出口:
options.Transparent = false;
  • 查看内容可见性 隐藏的行、合并细胞或评论.
  • 使用 PNG 格式支持透明度 或当质量优先时.
  • 使用 JPEG 用于照片重型工作表 在文件大小比完美的清晰度更重要.
  • 使用 OnePagePerSheet = true 以防止内容分成多个图像.

故障排除常见问题

问题解决方案
图像包含额外列/列确保印刷区域严格定义
不適當地挖掘的範圍设置 OnePagePerSheet = true
Blurry 文本或图像提高分辨率设置
圖片顯示 blurry增加 ChartImageWidth 和 ChartImageHeight
图像缺乏清晰度使用 SmoothingMode = SmoothingMode.AntiAlias
圖片已被剪輯查看工作表边缘或规模设置
输出图像是白色确保工作簿充电并包含可见的数据
图像被切断设置 OnePagePerSheet = true 或调整页面扩展
错误:“未找到文件"确认源 Excel 文件路径是有效和可用
错误:“未支持的文件格式"确保输入文件类型支持

结论

Aspose.Cells Image Converter for .NET 提供了一个坚实的解决方案,以将 Excel 内容转换为高品质的图像. 无论您正在使用整个工作簿、单个工作表、图表或特定细胞序列,这个强大的图书馆都提供了任何 Excel 图像转换场景所所需的灵活性和控制.

通过遵循本指南中列出的技术和最佳做法,您可以确保您的 Excel 数据在您所选择的图像格式中以像素准确度呈现.

开始利用权力 Aspose.Cells 图像转换器 今天将您的 Excel 数据转化为视觉强迫图像,用于任何目的.

More in this category