Pemecahan Masalah Aspose.Words FOSS for .NET

Halaman ini mencakup masalah umum yang ditemui saat membangun dan menggunakan Aspose.Words FOSS untuk .NET, serta cara menyelesaikannya.

Masalah Build dan Instalasi

dotnet add package Aspose.Words tidak dapat menemukan paket

Perintah itu mengarah ke paket Aspose.Words komersial, bukan edisi FOSS — ID paket FOSS adalah Aspose.Words.FOSS:

dotnet add package Aspose.Words.FOSS

Atau, jalankan git clone untuk mendapatkan sumbernya, lalu cd ke folder yang dikloning dan jalankan dotnet build pada solusi:

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 sendiri alih-alih referensi paket.

Referensi proyek tidak terpecahkan setelah cloning

Pastikan referensi mengarah ke Aspose.Words.csproj di dalam folder Aspose.Words-FOSS-for-.NET/Aspose.Words/ yang telah di-clone, dan bahwa solusi telah berhasil dibangun terlebih dahulu (dotnet build Aspose.Words.sln -c Release). Perpustakaan menargetkan .NET Standard 2.0, sehingga SDK apa pun yang menargetkan .NET Framework 4.6.2+ atau .NET 6/8/10 dapat merujuknya.

Masalah Memuat

UnsupportedFileFormatException saat memuat dokumen

UnsupportedFileFormatException dilemparkan selama proses pemuatan ketika format file tidak dikenali atau tidak didukung oleh edisi ini. Format pemuatan edisi ini adalah DOCX, DOCM, DOTX, DOTM, Flat OPC, Markdown, dan teks biasa — memberikan jalur yang tidak didukung seperti input.doc ke konstruktor Document akan memicu pengecualian ini alih-alih mengembalikan dokumen yang dimuat:

using Aspose.Words;

try
{
    Document doc = new Document("input.doc");
}
catch (UnsupportedFileFormatException ex)
{
    Console.WriteLine("Format not supported by this edition: " + ex.Message);
}

Menangkap UnsupportedFileFormatException di sekitar konstruktor Document memungkinkan Anda melaporkan pesan yang jelas alih-alih membiarkan pengecualian menyebar sebagai jejak tumpukan mentah.

FileCorruptedException pada file yang tampak valid

FileCorruptedException dilempar saat pemuatan ketika file tampak rusak dan tidak dapat diparsir — misalnya, file .docx yang bukan paket OOXML berbasis ZIP yang valid, atau file yang terpotong selama transfer. Dapatkan kembali file dari sumbernya dan pastikan file terbuka dengan benar sebelum memuatnya dengan Document.

IncorrectPasswordException saat membuka dokumen yang dilindungi

Ini dilempar ketika sebuah dokumen dienkripsi dengan kata sandi dan kata sandi yang diberikan ke overload LoadOptions konstruktor Document tidak ada atau salah. Berikan kata sandi yang benar melalui LoadOptions.Password sebelum memuat.

Masalah Penyimpanan dan Ekspor

Document.Save() ke ekstensi PDF, XPS, atau gambar gagal

Edisi ini tidak menyertakan subsistem tata letak halaman dan perenderan, sehingga Document.Save() tidak dapat mengekspor ke format PDF, XPS, atau gambar.

Simpan ke DOCX, DOCM, DOTX, DOTM, Flat OPC, Markdown, atau teks biasa sebagai gantinya — itu adalah format yang sebenarnya ditulis oleh edisi ini. Versi komersial Aspose.Words for .NET menambahkan output PDF, XPS, dan gambar.

Nomor halaman dan entri daftar isi selalu menampilkan 0

Aspose.Words FOSS untuk .NET mencakup mesin evaluasi bidang lengkap, sehingga bidang konten seperti DATE dan DOCPROPERTY diperbarui dengan benar. Bidang yang bergantung pada tata letak halaman — nomor halaman, NUMPAGES, dan entri TOC — dievaluasi menjadi placeholder 0 alih-alih nilai yang dihitung, karena edisi ini tidak menyertakan mesin tata letak yang biasanya mem-paginasi dokumen. Ini adalah perilaku yang diharapkan dalam edisi ini, bukan bug.

Masalah Tanda Tangan Digital

Menandatangani dokumen tidak menghasilkan efek apa pun

DigitalSignatureUtil.Sign() dan API penandatanganan terkait ada dalam model objek untuk kompatibilitas struktural dengan produk komersial, tetapi pembuatan tanda tangan baru tidak berfungsi dalam edisi FOSS ini — memanggilnya tidak menghasilkan output yang ditandatangani. Edisi ini dapat memeriksa dan memverifikasi tanda tangan yang sudah terlampir pada dokumen melalui Document.DigitalSignatures dan DigitalSignatureUtil.LoadSignatures(), tetapi alur kerja penandatanganan memerlukan Aspose.Words komersial untuk .NET.

Masalah Font

Font yang disematkan lebih besar dari yang diharapkan

Ketika EmbedTrueTypeFonts diaktifkan, font disematkan sebagai file lengkap bukan dipotong menjadi hanya glif yang sebenarnya digunakan dalam dokumen, sehingga file yang disimpan dengan font yang disematkan lebih besar daripada output setara dari produk komersial. Tidak ada solusi alternatif dalam edisi ini — subsetting font yang disematkan tidak disertakan.