Aspose.Words Document Converter untuk .NET
Aspose.Words Dokumen Converter untuk .NET adalah API ringan, berprestasi tinggi yang memberi tumpuan kepada format-to-format konversi. Ia menyokong senario biasa seperti Word → PDF, HTML → pdf , ** DOCX ↔ ODT** dan ** DOCX → Markdown**; PDF → imej (JPG/PNG/TIFF) serta berpuluh-puluh lagi – tanpa memerlukan Microsoft Office.
Pemasangan dan Setup
- Pemasangan Pakej NuGet
Aspose.Words
(Bahasa Inggeris kepada Melayu conversion). - Permohonan lesen yang diukur di startup untuk mengelakkan had penilaian: lihat Lisensi Pengukuran .
- Mengkaji keperluan rangka kerja dalam Panduan pemasangan .
Platform yang disokong
- Sistem operasi : Windows, Linux dan MacOS
- Rangka kerja : .NET Framework 4.x, .Net Standard 2.0 , .net Core 2.0–3.1 , Mono 5/6/7
- IDEs: Visual Studio 2017–2022, JetBrains Rider, MonoDevelop
Permulaan Cepat
1) Word → PDF (satu baris)
using Aspose.Words;
var doc = new Document("input.docx");
doc.Save("output.pdf");
2) HTML → PDF dengan pilihan
using Aspose.Words;
using Aspose.Words.Saving;
var doc = new Document("input.html");
var pdf = new PdfSaveOptions
{
Compliance = PdfCompliance.PdfA1b, // archival
EmbedFullFonts = false, // reduce size
OptimizationOptions = { ImageCompression = PdfImageCompression.Jpeg }
};
doc.Save("output.pdf", pdf);
Tag: DOCX untuk Markdown
using Aspose.Words;
using Aspose.Words.Saving;
var doc = new Document("spec.docx");
var md = new MarkdownSaveOptions
{
TableContentAlignment = MarkdownTableContentAlignment.Auto,
ListExportMode = MarkdownListExportMode.PlainText
};
doc.Save("spec.md", md);
4) PDF → imej (per halaman)
using Aspose.Words;
using Aspose.Words.Saving;
var pdfDoc = new Document("report.pdf");
var img = new ImageSaveOptions(SaveFormat.Png) { Resolution = 200 };
for (int page = 0; page < pdfDoc.PageCount; page++)
{
img.PageSet = new PageSet(page);
pdfDoc.Save($"report_page_{page + 1}.png", img);
}
5) Aliran → aliran (web / perkhidmatan)
using (var input = httpFile.OpenReadStream())
using (var output = new MemoryStream())
{
var doc = new Aspose.Words.Document(input); // auto-detects format
doc.Save(output, SaveFormat.Pdf);
output.Position = 0;
return File(output.ToArray(), "application/pdf", "converted.pdf");
}
Ciri-ciri dan fungsi
Penutup format yang luas
Kemasukan / output (dipilih):
- Keluarga kata: DOC, DOCX, DOT, RTF, WordML (XML)
- Layout tetap : PDF, daripada Perbincangan / ePub/)
Matriks penuh bersesuaian dengan keupayaan Aspose.Words.Jika kedua-dua plugin File Processor dan ini Converter hadir, anda boleh muat/edit terlebih dahulu dan kemudian mengeksport dalam format yang dikehendaki.
Pengesanan format automatik
API mengesan format daripada ** tajuk fail** atau ** kandungan aliran**, jadi anda boleh dengan selamat menerima muat naik arbitrari dalam perkhidmatan web.
Fine-Tuning dengan opsyen Simpan
- PDF: PDF/A‐1b/2u, penyulitan, bendera kebenaran, tandatangan digital, penulisan fon, kompresi imej.
- **HTML/MHTML: ** Pengendalian sumber (embed vs. eksternal), mod CSS, pengekodan, format imej & DPI.
- Gambar: DPI, kedalaman warna, kompresi, julat halaman, TIFF pelbagai halaman.
- Markdown: senarai dan gaya tajuk, penyelarasan jadual, pengeluaran pautan.
Pengenalan kepada Fidelity & Metadata
Ia menyimpan fon, gaya, jadual, tajuk / kaki, tanda-tanda air, komen, pecahan seksyen, dan ** sifat dokumen** (penulis, judul, medan disesuaikan.
Pemprosesan mesra pelayan
- Stream-first API, peruntukan rendah, buffer I/O.
- Async/batch penukaran dan paralel untuk penyebaran.
- Memori yang boleh disesuaikan & had pemprosesan halaman untuk docs besar.
Diagnosis dan Rintangan
Pengecualian yang jelas mengenai input yang rosak/tidak disokong; melompat ke logging/telemetry untuk menangkap tempoh, bilangan halaman, dan sebab kegagalan untuk SLA pengesanan.
Resep Penukaran Popular
- DOCX → PDF/XPS untuk pengedaran & arkib (pilihan PDF/A).
- HTML → PDF untuk invois, pernyataan, dan laporan dengan halaman yang konsisten.
- DOCX ↔ ODT untuk interoperabiliti cross-suite.
- DOCX → Markdown untuk menerbitkan dokumen teknologi.
- PDF → PNG/JPEG/TIFF untuk menghasilkan preview atau miniatur.
- Word/HTML → EPUB untuk aliran kerja e-book.
Petua: Gunakan PageSet untuk mengeksport halaman atau julat tertentu; digabungkan dengan ImageSaveOptions bagi sprit atau thumbnails.
amalan terbaik
- Lisensi pertama: memulakan lesen yang diukur sebelum sebarang penukaran untuk mengelakkan penilaian air.
- Suka aliran dalam perkhidmatan untuk melepaskan cakera I/O dan mengurangkan latensi.
- Pengesahan awal: memeriksa byte sihir atau cuba beban kering untuk gagal dengan cepat.
- Keluaran saiz kanan: pilih DPI sensitif, elakkan daripada memasukkan setiap fon jika tidak diperlukan; pilih PDF/A hanya apabila pematuhan diperlukan.
- Tag: kebersihan sumber : wrap
Document
dan aliran dalamusing
daripada blok. - Konkuren: Penggunaan jangka pendek
Document
contoh per permintaan; menggunakan kolam untuk pilihan jika perlu. - Pengamatan: bilangan halaman log, tempoh, dan set opsyen; menandakan kegagalan dengan ID korelasi.
FAQ
**Adakah ia memerlukan Microsoft Office?**Bukan itu sahaja, ia merupakan API yang unik.
**Bolehkah saya menukar tanpa menyentuh sistem fail?**Semua penukaran boleh menjadi Stream → Stream.
**Bagaimana saya boleh melaksanakan PDF/A?**Set PdfSaveOptions.Compliance = PdfCompliance.PdfA1b
(atau 2u) sebelum menjimatkan.
**Bolehkah saya melindungi kata laluan PDF?**Ya. Mengesetkan penyulitan dan izin bendera dalam PdfSaveOptions
.
**Adakah Markdown round-trip selamat?**Jadual, senarai, tajuk, pautan, dan pemformatan inline disokong dengan pilihan tunable.
**Bagaimana saya boleh menukar halaman tertentu?**Use PageSet
dalam ImageSaveOptions
atau FixedPageSaveOptions
‑Kelas yang dikeluarkan.