Mail Merge dari Excel di C# | Excel Mail Merge ke Excel

Mail merge membuatnya mudah untuk membuat dokumen yang dipersonalisasi dalam jumlah besar, seperti surat, email, faktur, atau sertifikat. Anda mulai dengan sebuah template dan mengisinya menggunakan data dari spreadsheet. Setiap baris dalam file Excel menghasilkan dokumen baru dengan rincian yang benar di tempat yang tepat. Ini adalah cara yang cerdas untuk mengotomatiskan tugas yang berulang seperti mengirim faktur atau menghasilkan laporan. Dalam posting ini, kami akan menunjukkan kepada Anda bagaimana cara melakukan mail merge dari Excel menggunakan C#. Mari kita mulai.

Artikel ini mencakup topik-topik berikut:

C# Mail Merge Excel Library

Kami akan menggunakan API Aspose.Cells for .NET untuk melakukan penggabungan surat dari Excel di C#. Ini menawarkan alat yang kuat untuk bekerja dengan file Excel langsung dalam kode Anda. Ini memungkinkan pengembang untuk membuat, membaca, dan memperbarui spreadsheet dengan mudah. Anda juga dapat menangani tugas lanjutan seperti penggabungan surat tanpa kesulitan. Perpustakaan ini membuat otomatisasi Excel cepat, fleksibel, dan andal.

Untuk memulai dengan Aspose.Cells for .NET, ikuti instruksi instalasi sederhana ini:

  1. Silakan unduh dari releases.
  2. Instal perpustakaan menggunakan NuGet Package Manager dengan perintah berikut:
PM> Install-Package Aspose.Cells

Bagaimana Cara Kerja Mail Merge dengan Aspose.Cells?

Aspose.Cells tidak mendukung `mail merge” dengan cara yang sama seperti Word.Ini menambahkan mail merge ke Excel menggunakan Smart Markers.Marker ini bertindak sebagai tempat penampung di spreadsheet Anda, dan pustaka menggantinya dengan data nyata saat runtime. Saat mengolah setiap baris dari sumber data Anda, ia mengisi template dan memperluas konten secara otomatis, memungkinkan Anda menghasilkan dokumen yang sepenuhnya dipersonalisasi hanya dengan beberapa baris kode C#.

&=DataSource.ColumnName

Selama pemrosesan, Aspose.Cells mengganti ini dengan data aktual dari DataTable, List<T>, atau IEnumerable mana pun. Misalnya, perpustakaan mengganti &=Data.Name dengan nilai dari kolom Nama di tabel Data.

Siapkan Template Excel

Buat file Excel (misalnya, Template.xlsx) dengan penanda cerdas. Berikut adalah contoh tata letak:

NamaEmailJumlah
&=Data.Name&=Data.Email&=Data.Amount

Panduan Langkah demi Langkah untuk Melakukan Mail Merge dari Excel di C#

Untuk melakukan mail merge dari Excel menggunakan Aspose.Cells for .NET, cukup ikuti langkah-langkah berikut:

Langkah 1: Muat Template Excel

Muatan file template Excel yang berisi Smart Markers menggunakan kelas Workbook. Kelas Workbook mewakili seluruh file Excel (buku kerja).File template yang dimuat bertindak sebagai tata letak untuk keluaran gabungan Anda.

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

Langkah 2: Buat DataTable

Di sini, kami membuat sebuah DataTable yang mensimulasikan sumber data Excel Anda. Setiap kolom cocok dengan marker pintar, dan setiap baris mewakili satu set nilai untuk dimasukkan. Kelas DataTable dari System.Data menyimpan data yang ingin Anda gabungkan. Setiap kolom cocok dengan marker pintar, dan setiap baris memberikan set nilai yang unik.

DataTable dt = new DataTable("Data");
dt.Columns.Add("Name");
dt.Columns.Add("Email");
dt.Columns.Add("Amount");

dt.Rows.Add("Alice", "alice@example.com", 1000);
dt.Rows.Add("Bob", "bob@example.com", 1500);

Langkah 3: Tautkan Template Excel Anda ke Sumber Data

Kami menggunakan kelas WorkbookDesigner untuk menghubungkan template dengan data. WorkbookDesigner adalah kelas khusus dalam Aspose.Cells yang dirancang untuk menangani penanda cerdas dan pengikatan data. Ini menghubungkan sumber data Anda (seperti DataTable) dengan template Excel. Metode SetDataSource() mengikat DataTable (Data) ke penanda cerdas di dalam workbook.

WorkbookDesigner designer = new WorkbookDesigner(workbook);
designer.SetDataSource(dt);
  • SetDataSource() menghubungkan DataTable ke Smart Markers di workbook.
  • "Data" adalah nama yang digunakan dalam penanda seperti &=Data.Name.

Langkah 4: Jalankan Mail Merge

Setelah Anda mengatur sumber data, memanggil Process() mengisi semua Smart Markers dengan nilai nyata dari DataTable. Perintah ini menjalankan penggabungan surat. Itu melalui Smart Markers dan menggantinya dengan nilai aktual dari sumber data.

designer.Process();

Langkah 5: Simpan File

Akhirnya, kami menyimpan file yang telah selesai dengan semua data yang digabungkan.

workbook.Save("MergedOutput.xlsx");

Simpan Output yang Digabungkan sebagai PDF

Anda dapat dengan mudah menyimpan dokumen Excel yang digabungkan sebagai PDF dengan satu baris kode.

// Set PDF options
PdfSaveOptions options = new PdfSaveOptions();

// Save as PDF
workbook.Save("MergedDocument.pdf", SaveFormat.Pdf);

Complete C# Code to Mail Merge Data

// Muatan template Excel
Workbook workbook = new Workbook("Template.xlsx");

// Buat data dummy
DataTable dt = new DataTable("Data");
dt.Columns.Add("Name");
dt.Columns.Add("Email");
dt.Columns.Add("Amount");

dt.Rows.Add("Alice", "alice@example.com", 1000);
dt.Rows.Add("Bob", "bob@example.com", 1200);

// Atur sumber data
WorkbookDesigner designer = new WorkbookDesigner(workbook);
designer.SetDataSource(dt);

// Proses penanda pintar (gabungan surat)
designer.Process();

// Save the output
workbook.Save("MergedOutput.xlsx");

Output

File Excel hasil keluaran berisi satu baris untuk setiap entri dengan data yang dipersonalisasi diisi menggantikan penanda pintar.

Mail Merge dari Excel di C# - Output

Mail Merge dari Excel di C# - Output

Dapatkan Lisensi Gratis

Dapatkan lisensi sementara gratis yang memungkinkan Anda menguji semua fitur Aspose.Cells for .NET tanpa batasan. Ini sangat ideal jika Anda mengevaluasi API untuk tugas otomatisasi seperti penggabungan email, pelaporan Excel, atau ekspor PDF.

Excel to Excel Mail Merge: Sumber Gratis

Selain penggabungan surat Excel, kami menyediakan berbagai sumber daya untuk membantu Anda memperdalam pemahaman Anda tentang Aspose.Cells for .NET. Lihat dokumentasi kami, tutorial, dan forum komunitas untuk wawasan lebih lanjut.

Pertanyaan yang Sering Diajukan (FAQs)

Q1: Apakah saya bisa menggunakan mail merge Excel tanpa menginstal Microsoft Office?

Ya, mail merge tidak memerlukan Microsoft Office. Aspose.Cells berjalan secara independen dan menangani segala sesuatunya melalui API-nya sendiri.

Q2: Apa perbedaan antara Smart Markers dan Word Merge Fields?

Smart Markers bekerja dalam Excel dan lebih dapat disesuaikan untuk perluasan data baris. Merge fields spesifik untuk Word.

Q3: Bisakah saya menggabungkan dari Excel ke Word menggunakan Aspose?

Ya, tetapi Anda akan memerlukan Aspose.Words untuk skenario itu.

Q4: Apakah mungkin untuk mengotomatiskan pembuatan PDF dari penggabungan Excel?

Tentu saja. Cukup simpan workbook akhir dalam format PDF menggunakan Aspose.Cells.

Kesimpulan

Mail merge dari Excel menawarkan cara yang kuat untuk menghasilkan dokumen yang dinamis dan dipersonalisasi menggunakan antarmuka spreadsheet yang familiar. Dalam posting blog ini, kami menjelaskan tentang mail merge dari Excel menggunakan C#. Dengan menggunakan Aspose.Cells Smart Markers, Anda mendapatkan fleksibilitas untuk mengotomatisasi proses ini sepenuhnya dan menghasilkan ribuan faktur, sertifikat, atau laporan terstruktur lainnya.

Jika Anda memiliki pertanyaan atau membutuhkan bantuan lebih lanjut, silakan hubungi kami di free support forum.

Lihat Juga