Ketika bekerja dengan fitur preview dokumen atau perpustakaan konten, gambar mini memberikan referensi visual yang cepat tanpa memuat seluruh file. tutorial ini menunjukkan bagaimana untuk membuat gambar mini dari file Excel menggunakan Aspose.Cells untuk .NET.
Pengenalan
Mencipta template dari file Excel dapat sangat berguna dalam berbagai aplikasi seperti galeri dokumen, dashboard, dan alat pencarian. Template menawarkan referensi visual yang cepat tanpa perlu mengisi dokumen penuh, menjadikannya ideal untuk preview ringan.
Dalam tutorial ini, kami akan mengeksplorasi bagaimana untuk menghasilkan gambar mini dari file Excel menggunakan Aspose.Cells untuk .NET. Kami akan mencakup pemasangan, opsi rendering, teknik resizing, dan praktik terbaik untuk memastikan kualitas mini yang dioptimalkan untuk kinerja.
Panduan Langkah-Langkah
Langkah 1: Menginstal Aspose.Cells
Sebelum Anda mulai membuat miniatur, pastikan Anda memiliki Aspose.Cells untuk .NET terinstal. Anda dapat menginstalnya melalui NuGet Package Manager dengan perintah berikut:
Install-Package Aspose.Cells
Langkah 2: Mengisi buku kerja
Setelah Aspose.Cells dipasang, muat buku kerja Excel Anda dan masuk ke lembar kerja yang ingin Anda konversi menjadi miniatur.
Workbook workbook = new Workbook("FinanceReport.xlsx");
Worksheet sheet = workbook.Worksheets[0];
Langkah 3: Mengkonfigurasi Opsi Rendering Thumbnail
Untuk menghasilkan miniatur, mengkonfigurasi opsi rendering untuk gambar resolusi rendah. ini memastikan bahwa miniature yang dihasilkan ringan dan cepat untuk dimuat.
ImageOrPrintOptions options = new ImageOrPrintOptions
{
ImageType = ImageType.Png,
HorizontalResolution = 96,
VerticalResolution = 96,
OnePagePerSheet = true
};
Langkah 4: Mengalihkan lembar kerja pertama ke gambar
Penggunaan SheetRender untuk membuat lembar kerja sebagai file gambar sementara.
SheetRender renderer = new SheetRender(sheet, options);
renderer.ToImage(0, "preview_temp.png");
Langkah 5: Mengalihkan gambar ke dimensi Thumbnail (optional)
Anda dapat menggunakan System.Drawing untuk mengubah file gambar sementara ke dimensi mini yang diinginkan.
using System.Drawing;
Bitmap original = new Bitmap("preview_temp.png");
Bitmap thumbnail = new Bitmap(original, new Size(160, 120));
thumbnail.Save("thumbnail.png");
Langkah 6: Gunakan gambar Thumbnail
Sekarang Anda memiliki miniatur ringan yang cocok untuk previews.
Contoh lengkap kode
Berikut adalah kode contoh lengkap yang menggabungkan semua langkah yang disebutkan di atas:
using System;
using System.Drawing;
using Aspose.Cells;
using Aspose.Cells.Rendering;
class Program
{
static void Main()
{
// Load Excel file
Workbook workbook = new Workbook("FinanceReport.xlsx");
Worksheet sheet = workbook.Worksheets[0];
// Configure low-resolution options
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
using (Bitmap original = new Bitmap("preview_temp.png"))
{
Bitmap thumbnail = new Bitmap(original, new Size(160, 120));
thumbnail.Save("thumbnail.png");
}
Console.WriteLine("Thumbnail image created from Excel worksheet.");
}
}
Praktik Terbaik
| Rekomendasi | Tujuan |
|---|---|
Penggunaan OnePagePerSheet = true | Menghindari pembagian multi-page dalam gambar |
| Resolusi rendah | Optimisasi untuk generasi mini yang lebih cepat |
| Mengalihkan gambar setelah rendering | Lebih banyak kontrol skala dan kualitas |
