Aspose.Words Belge Dönüştürücüsü for .NET

Aspose.Words Dokument Converter for .NET, format-to-format dönüşümü üzerine odaklanan hafif, yüksek performanslı bir API’dir. Word → PDF gibi yaygın senaryoları desteklemektedir., HTML → pdf , DOCX ↔ ODT***, * DOCX → Markdown** PDF → resimler (JPG/PNG/TIFF) ve onlarca daha fazlası - Microsoft Office gerektirmeden.

Yükleme ve Setup

  • NuGet paketini kurun Aspose.Words (Core API güçlendirme dönüşümleri).
  • Değerlendirme sınırlarını önlemek için başlangıçta ölçülen lisans uygulaması: bakınız Ölçümlü Lisanslama .
  • Çerçeve gereksinimlerini incelemek için Yükleme Rehberi .

Desteklenen platformlar

  • Windows, Linux ve MacOS
  • Çerçeve: .NET Framework 4.x, .net Standard 2.0, ,NET Core 2.0–3.1 ve Mono
  • IDEs: Visual Studio 2017–2022, JetBrains Rider, MonoDevelop

hızlı başlangıç

1) Word → PDF (bir çizgi) 

using Aspose.Words;
var doc = new Document("input.docx");
doc.Save("output.pdf");

2) HTML → PDF seçenekleri ile 

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);

3) DOCX → 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 → resimler (sayfa başına) 

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) Akış → akış (web/hizmet) 

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");
}

Özellikler ve Fonksiyonel

Geniş format kapak

Giriş / çıkış seçeneği):

  • Word aile: DOC, DOCX, DOT, RTF, WordML (XML)
  • Düzleştirilmiş düzen: PDF, OTT Yorumlar / EPUB/)

Tam matris Aspose.Words özellikleri ile uyumludur. eğer hem bir **File Processor ** eklentisi hem de bu Converter mevcutsa, önce yükleyebilir / düzenleyebilirsiniz ve daha sonra istenen biçimde ihraç edebilirsiniz.

Otomatik format algılama

API ** dosya başlıkları ** veya ** akış içeriği** formatını tespit eder, böylece web hizmetlerinde isteğe bağlı yüklemeyi güvenli bir şekilde kabul edebilirsiniz.

Fine-Tuning ile Kaydetme Seçenekleri

  • PDF: PDF/A-1b/2u, şifreleme, izin bayrakları, dijital imzalar, yazı tipi yerleştirme, görüntü sıkıştırma.
  • HTML / HTML: kaynak yönetimi (dış vs. dış), CSS modu, kodlama, görüntü biçimi & DPI.
  • Görüntüler: DPI, renk derinliği, sıkıştırma, sayfa aralığı, çok sayfalık TIFF.
  • Markdown: listeler ve başlık stiller, tablo uyumluluğu, bağlantı üretimi.

Etiket Arşivi: Fidelity & Metadata

Yazılar, stiller, tablolar, başlıklar/yürüyenler, su işaretleri, yorumlar, bölüm boşlukları ve doküman özellikleri (Yazar, Başlık, özelleştirilmiş alanlar) korur.

Servis dostu işleme

  • Stream-first API, düşük dağıtımlar, buffer I/O.
  • Async/batch dönüştürme ve paralelleştirme geçiş için.
  • Büyük dokular için ayarlanabilir hafıza ve sayfa işleme sınırları.

Diş ve dayanıklılık

Yolsuz / desteklenmemiş girişler için açık istisnalar; kaydetme süresi, sayfa sayısı ve başarısızlık nedenleri yakalamak için kayıt / telemetriye girin SLA izlemek için.

Popüler dönüşüm tarifleri

  • **DOCX → PDF/XPS ** dağıtım ve arşivleme için (opsiyonel olarak PDF/A).
  • HTML → PDF tutarlı sayfa ile faturalar, ifadeler ve raporlar için.
  • DOCX ↔ ODT cross-suite işbirliği için.
  • DOCX → Markdown Teknoloji dokularını yayınlamak için.
  • PDF → PNG/JPEG/TIFF önizlemeler veya küçük resimler oluşturmak için.
  • Word/HTML → EPUB e-kitap çalışma akışları için.

İpucu: **PageSet ** kullanarak belirli sayfaları veya satırları ihraç edin; ImageSaveOptions ile birleştirin.

En İyi Uygulamalar

  • License first : Değerlendirme su işaretlerinden kaçınmak için herhangi bir dönüşümden önce ölçülen lisanslamayı başlatın.
  • Disk I/O’yu geçmek ve gecikmeyi azaltmak için hizmetlerde akış tercih eder.
  • Erken doğrulama : sihirli baytları kontrol edin veya hızlı bir şekilde başarısız olmak için kuru bir yük deneyin.
  • **Doğru boyutlu çıkış ** : hassas DPI’yi seçin, gerekli olmadıkça her yazı tipi yerleştirmekten kaçının; PDF/A ‘yı yalnızca uyumluluk gerektirdiğinde seçiniz.
  • Kaynak hijyeni : kapak Document ve akıntılar içinde using bloklar için.
  • Güvenlik : kısa ömürlü kullanım Document İsteğe göre örnekler; ihtiyaç duyulduğunda seçenekler için havuzları kullanın.
  • Görünürlük : sayfa sayımları, süresi ve seçenek setleri; korelasyon kimlikleri ile hataları etiketlemek.

FAQ Hakkında

**Microsoft Office’e ihtiyacınız var mı?**Hayır, bu bir standalone API.

**Dosya sistemine dokunmadan dönüştürülebilir miyim?**Evet. tüm dönüşümler Stream → Stream olabilir.

**PDF / A nasıl uygulayabilirim?**seti PdfSaveOptions.Compliance = PdfCompliance.PdfA1b (veya 2u) tasarruf öncesinde.

**PDF’leri şifre ile koruyabilir miyim?**Evet. şifreleme ve izin bayrakları ayarlayın PdfSaveOptions.

**Markdown round-trip güvenli mi?**Tablolar, listeler, başlıklar, bağlantılar ve inline biçimlendirme, tünel seçenekleri ile desteklenir.

**Belirli sayfaları nasıl dönüştürüyorum?**Kullanımı PageSet içinde ImageSaveOptions veya FixedPageSaveOptions‑Derivatif sınıflar.

 Türkçe