Pendahuluan
Aspose.Words FOSS untuk .NET kini tersedia: perpustakaan .NET gratis dan sumber terbuka untuk membuat, membaca, dan mengedit dokumen Word dalam C# murni, tanpa memerlukan instalasi Microsoft Word. Ini ditujukan bagi pengembang yang perlu menghasilkan laporan dan surat dari templat, membaca serta merestrukturisasi konten dari file .docx yang ada, atau mengonversi dokumen Word ke Markdown atau teks biasa sebagai bagian dari pipeline pemrosesan, tanpa harus melisensikan SDK komersial untuk melakukannya.
Perpustakaan ini dirilis di bawah lisensi MIT dan tidak memiliki dependensi native — semuanya berjalan dalam kode terkelola. Ini menargetkan .NET Standard 2.0, sehingga dapat berjalan pada .NET Framework 4.6.2+ dan .NET 6, 8, dan 10, di Windows, Linux, dan macOS. Instal melalui NuGet, atau bangun perpustakaan dari sumber dengan satu perintah dotnet build (lihat Quick Start di bawah).
Apa yang membedakan ini dari perpustakaan dokumen sumber terbuka baru yang tipikal adalah bahwa ini bukan penulisan ulang atau pembungkus. Aspose.Words FOSS untuk .NET adalah basis kode Aspose.Words yang asli — mesin dokumen yang sama yang telah memproses dokumen Word dalam produksi sejak 2003 — disederhanakan menjadi inti gratis berlisensi MIT. Pengembang yang outgrow edisi ini dan membutuhkan tata letak halaman, rendering, atau konverter format tambahan dapat beralih ke versi komersial Aspose.Words untuk .NET tanpa menulis ulang kode mereka, karena ini adalah API yang mendasari yang sama.
Fitur Utama
Pembuatan dan Penyuntingan Dokumen
Buat dokumen dari awal dengan new Document() dan DocumentBuilder tingkat tinggi, atau buka file .docx yang ada dengan new Document(fileName). DocumentBuilder menyediakan metode penulisan berurutan seperti Write(), Writeln(), InsertParagraph(), dan InsertBreak(), bersama properti pemformatan (Font, ParagraphFormat, PageSetup) yang diterapkan pada konten saat dimasukkan. Untuk akses tingkat rendah, telusuri pohon dokumen secara langsung melalui node Section, Paragraph, Run, dan Table, atau buat subclass DocumentVisitor untuk memproses setiap tipe node dalam satu kali lintasan.
Tabel dan Daftar
Tabel dibangun dari node Table, Row, dan Cell. Table.SetBorders(), Table.SetShading(), dan Table.AutoFit() memformat seluruh tabel sekaligus, sementara Table.Rows dan akses Cell per baris memberikan kontrol yang lebih halus. Daftar bernomor dan berpoin melalui ListCollection dan ListFormat: terapkan gaya bawaan dengan ListFormat.ApplyBulletDefault() atau ApplyNumberDefault(), atau daftarkan definisi daftar khusus dengan ListCollection.Add().
Perubahan Terlacak dan Perlindungan Dokumen
Panggil Document.StartTrackRevisions() sebelum mengedit untuk merekam penyisipan, penghapusan, dan perubahan format, kemudian periksa, terima, atau tolak mereka melalui RevisionCollection (AcceptAll(), RejectAll(), Accept(criteria), Reject(criteria)), atau terima semuanya sekaligus dengan Document.AcceptAllRevisions(). Document.Protect() menerapkan perlindungan sandi atau penegakan baca‑saja menggunakan enum DocumentSecurity (ReadOnlyEnforced, ReadOnlyRecommended, PasswordProtected, dan nilai terkait), dan Document.Unprotect() membaliknya.
Field, Makro, dan Tanda Tangan Digital
Mesin evaluasi bidang memperbarui bidang seperti FieldDate (bidang DATE) dan FieldDocProperty (bidang DOCPROPERTY) secara langsung melalui Document.UpdateFields() — bidang yang bergantung pada tata letak halaman, seperti nomor halaman, dievaluasi menjadi nilai placeholder karena tata letak halaman bukan bagian dari edisi ini. File DOCM dan DOTM dapat dipertahankan (round‑trip) dengan proyek VBA mereka tetap utuh. Tanda tangan digital yang ada dapat diperiksa melalui DigitalSignatureCollection dan DigitalSignature (IsValid, SubjectName, IssuerName, SignTime) untuk memastikan apakah dokumen ditandatangani dan tidak diubah; pembuatan tanda tangan baru bukan bagian dari edisi ini.
Diagram
Sisipkan diagram ke dalam dokumen dengan DocumentBuilder.InsertChart(), lalu konfigurasikan rangkaian datanya melalui objek Chart yang dikembalikan.
using Aspose.Words;
using Aspose.Words.Drawing.Charts;
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape shape = builder.InsertChart(ChartType.Line, 432, 252);
Chart chart = shape.Chart;
// Delete default generated series.
chart.Series.Clear();
string[] categories = new string[] { "AW Category 1", "AW Category 2", "AW Category 3" };
chart.Series.Add("AW Series 1", categories, new double[] { 4.3, 2.5, 3.5 });
doc.Save("chart.docx");
Panduan Cepat
Aspose.Words FOSS untuk .NET tersedia melalui NuGet:
dotnet add package Aspose.Words.FOSSUntuk membangun dari sumber sebagai gantinya:
git clone https://github.com/aspose-words-foss/Aspose.Words-FOSS-for-.NET.git
cd Aspose.Words-FOSS-for-.NET
dotnet build Aspose.Words.sln -c Release
Kemudian tambahkan referensi proyek ke Aspose.Words.csproj dari aplikasi Anda. Dengan referensi tersebut, buat dokumen dengan diagram dan simpan sebagai DOCX:
using Aspose.Words;
using Aspose.Words.Drawing.Charts;
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape shape = builder.InsertChart(ChartType.Line, 432, 252);
Chart chart = shape.Chart;
// Delete default generated series.
chart.Series.Clear();
string[] categories = new string[] { "AW Category 1", "AW Category 2", "AW Category 3" };
chart.Series.Add("AW Series 1", categories, new double[] { 4.3, 2.5, 3.5 });
doc.Save("chart.docx");
Console.WriteLine("Saved chart.docx");
Format yang Didukung
| Format | Ekstensi | Baca | Tulis |
|---|---|---|---|
| DOCX | .docx | ✓ | ✓ |
| DOCM | .docm | ✓ | ✓ |
| DOTX | .dotx | ✓ | ✓ |
| DOTM | .dotm | ✓ | ✓ |
| Flat OPC (semua varian) | (berbagai) | ✓ | ✓ |
| Markdown | .md | ✓ | ✓ |
| Text | .txt | ✓ | ✓ |
Edisi ini secara sengaja mengecualikan tata letak halaman dan rendering — tidak ada ekspor PDF, XPS, atau gambar, dan tidak ada pencetakan, yang juga berarti nilai bidang yang bergantung pada tata letak seperti nomor halaman dievaluasi sebagai placeholder alih-alih dihitung. Konverter format tambahan (DOC, RTF, ODT, HTML, EPUB, MHTML, MOBI, AZW3, dan WordML) tidak dibaca atau ditulis, dan eksekusi mail merge, LINQ Reporting, perbandingan dokumen, pembuatan tanda tangan digital baru, serta subset font yang disematkan tidak termasuk. Ini adalah subsistem yang sama yang dihapus dari basis kode komersial untuk menjaga edisi ini gratis.
Sumber Terbuka & Lisensi
Aspose.Words FOSS untuk .NET dirilis di bawah lisensi MIT, gratis untuk penggunaan komersial maupun pribadi tanpa royalti atau pembatasan redistribusi. Sumber lengkap tersedia di GitHub dalam the Aspose.Words FOSS untuk .NET repositori.
