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 dalam using 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.

 Melayu