Aspose.Words dokumentkonverter for .NET

Aspose.Words Dokument Converter for .NET er en mild, høy ytelse API fokusert på format-til-format konvertering. Det støtter vanlige scenarier som Word → PDF, HTML → pdf, DOCX ↔ ODT , DOCX → Markdown., PDF → bilder (JPG/PNG/TIFF) og dusinvis mer – uten å kreve Microsoft Office.

Installasjon og installasjon

  • Installere NuGet-pakken Aspose.Words (Core API styrer konverteringer).
  • Anvend målt lisens ved startup for å unngå evalueringsgrenser: se målt lisens .
  • Oversikt over rammevilkårene i Installeringsguide .

Støttede plattformer

  • OS: Windows, Linux og macOS
  • Frameworks: .NET Framework 4.x, .Net Standard 2.0,.NET Core 2.0–3.1, .net 5/6/7+, Mono
  • IDEs: Visual Studio 2017–2022, JetBrains Rider, MonoDevelop

Rask start

1) Word → PDF (one-liner) 

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

2) HTML → PDF med alternativer 

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 → bilder (per side) 

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

Strøm → Stream (web/tjeneste) 

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

Egenskaper og funksjonalitet

Bredt format dekning

Inn/Utgang (valgt):

  • Word familie: DOC, DOCX, DOT, RTF, WordML (XML)
  • Fiksert layout: PDF, OTT Informasjon / ePub/)

Full matrix alignes med Aspose.Words-funksjoner. Hvis både en File Processor plugin og denne Converter er til stede, kan du laste/redigere først og deretter eksportere i ønsket format.

Automatisk formatdeteksjon

APIen oppdager format fra filerhoveder eller streaminnhold, slik at du trygt kan akseptere vilkårlige nedlastinger i webtjenester.

Fine-Tuning med Save Options

  • PDF: PDF/A‐1b/2u, kryptering, tillatelse flagg, digitale signaturer, fonting, bilde komprimering.
  • HTML/MHTML: ressurshåndtering (embed vs. ekstern), CSS-modus, koding, bildeformat & DPI.
  • Bilder: DPI, farge dybde, komprimering, side rekkefølge, multi-page TIFF.
  • Markdown: liste og heading stiler, tabell tilpasning, link generasjon.

Layout Fidelity og Metadata

Oppbevarer bokstaver, stiler, tabeller, headers/footers, watermarks, kommentarer, seksjonsbreaks, og dokument egenskaper (forfatter, titel, tilpassede felt.

Server-vennlig behandling

  • Stream-first APIs, lave tildelinger, buffert I/O.
  • Async/batch konvertering og parallellisering for gjennomføring.
  • Konfigurerbar hukommelse og sidebehandlingsgrenser for store dokker.

Diagnostikk og resilens

Klar unntak på korrupte / ustøttet inntekter; hoppe inn i logging / telemetri for å fange varighetene, siden teller og manglende årsaker til SLA og sporing.

Populære konverteringsresepter

  • DOCX → PDF/XPS for distribusjon og arkivering (alternativt PDF/A).
  • HTML → PDF for fakturaer, uttalelser og rapporter med konsekvent sideformasjon.
  • DOCX ↔ ODT for cross-suite interoperabilitet.
  • DOCX → Markdown for å publisere teknisk dokumentasjon.
  • PDF → PNG/JPEG/TIFF for å generere forutsikter eller miniatyrer.
  • Word/HTML → EPUB for e-bok arbeidsflyter.

Tips: Bruk PageSet til å eksportere spesifikke sider eller ranger; kombiner med ImageSaveOptions for spriter eller miniater.

Beste praksis

  • License first: initialisere målt lisens før eventuelle konverteringer for å unngå evaluering av vannmarker.
  • foretrekker strømmer i tjenester for å skille disk I/O og redusere latens.
  • Valider tidlig: sjekk magiske byter eller prøv en tørr belastning for å mislykkes raskt.
  • Right-size output: velg sensitiv DPI, unngå å innlemme alle bokstaver med mindre det er nødvendig; Velg PDF/A bare når overholdelse er behov for.
  • Hygiene av ressurser: Wrap Document og strømmer i using Blokkene er.
  • Konkurranse: bruk kortlivet Document instanser per forespørsel; bruke bassenger for alternativer hvis det er nødvendig.
  • Observabilitet: log side tall, varighet, og alternativer sett; merking feil med korrelasjon IDs.

FAQ

**Er det behov for Microsoft Office?**No. Det er en standalone API.

**Kan jeg konvertere uten å berøre filsystemet?**Alle konverteringer kan være Stream → Stream.

**Hvordan kan jeg bruke PDF/A?**Set PdfSaveOptions.Compliance = PdfCompliance.PdfA1b (eller 2u) før du sparer.

**Kan jeg beskytte passord for PDF-er?**Ja. Konfigurer kryptering og tillatelse flagg i PdfSaveOptions.

**Er Markdown rund-trip trygg?**Tabeller, lister, overskrifter, lenker og inline formatering støttes med tunbare alternativer.

**Hvordan kan jeg konvertere spesifikke sider?**Use PageSet I ImageSaveOptions eller FixedPageSaveOptions‑Deriverte klasser.

 Norsk