Aspose.Words dokumentu konvertētājs .NET
Aspose.Words Dokumentu pārveidotājs .NET ir viegls, augstas veiktspējas API, kas vērsta uz format-to-format konversiju. tā atbalsta kopīgus scenārijus, piemēram, Word → PDF, HTML→PDF , DOCX ↔ ODT., DOCX → Markdown PDF → attēlus (JPG/PNG/TIFF) un desmitiem vairāk — bez Microsoft Office prasībām.
Instalācija un uzstādīšana
- Instalēt NuGet paketi
Aspose.Words
(Core API stiprina konversijas). - Pielietojiet mērītu licencēšanu start-up, lai izvairītos no novērtēšanas ierobežojumiem: skatīt Mērtēta licencēšana .
- Pārskats par pamatprasībām Instalācijas ceļvedis .
Atbalstītas platformas
- Operētājsistēma: Windows, Linux, MacOS
- Frammas: .NET Framework 4.x, .NET Standard 2.0, NET Core 2.0–3.1 un Mono 5/6/7
- IDEs: Visual Studio 2017–2022, JetBrains Rider, MonoDevelop
Ātrs sākums
1) Word → PDF (viena līnija)
using Aspose.Words;
var doc = new Document("input.docx");
doc.Save("output.pdf");
2) HTML → PDF ar iespējām
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 → attēli (par lapu)
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) Strēma → Stream (web / pakalpojums)
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");
}
Iezīmes un funkcionalitāte
Plaša formāta pārklājums
Ieeja / Izceļošana (izvēlēta):
- Word ģimene: DOC, DOCX, DOT, RTF, WordML (XML)
- Fiksēts izkārtojums: PDF, Attiecībā Tīmekļa vietne / EPUB/)
Ja ir pieejams gan File Processor un šis Converter plugins, vispirms varat lejupielādēt / rediģēt un pēc tam eksportēt vēlamā formātā.
Automātiskā formāta detekcija
API atklāj formātu no failu nosaukumiem vai stream saturu, lai jūs varētu droši pieņemt brīvprātīgus lejupielādējumus tīmekļa pakalpojumos.
Fine-Tuning ar Save Options
- PDF: PDF/A‐1b/2u, šifrēšana, atļaujas zīmes, digitālie paraksti, burtu iesaiņošana, attēla kompresija.
- HTML/MHTML: resursu apstrāde (embed vs. ārējais), CSS režīms, kodēšana, attēla formāts un DPI.
- Fotogrāfijas: DPI, krāsu dziļums, kompresijas, lapas diapazons, multi-page TIFF.
- Markdown: saraksts un nosaukuma stili, tabulas saskaņošana, saites ģenerācija.
Layout lojalitāte un metadati
Saglabā burtus, stili, tabulas, virsrakstus/pēdas, ūdenszīmes, komentārus, sadaļas pārtraukumus un dokumenta īpašības (autors, nosaukums, pielāgotās lapas.
Serveru draudzīga apstrāde
- Stream-first API, zems piešķiršanas līmenis, bufferēts I/O.
- Async/batch konversija un paralelizācija caurplūdes laikā.
- Konfigurējamas atmiņas un lapas apstrādes robežas lielām docēm.
Diagnoze un izturība
Atklāti izņēmumi par korumpētiem/neatbalstītiem ieņēmumiem; logging/telemetrija uzņemšanas ilgumu, lapu skaitīšanas un neveiksmes iemesliem SLA Spēlēšana.
Populāras konversijas receptes
- DOCX → PDF/XPS izplatīšanai un arhivēšanai (vēlami PDF/A).
- HTML → PDF rēķiniem, deklarācijām un ziņojumiem ar konsekventu pagināciju.
- DOCX ↔ ODT attiecībā uz cross-suite sadarbspēju.
- DOCX → Markdown, lai publicētu tehnoloģiju dokus.
- PDF → PNG/JPEG/TIFF, lai radītu priekšstatu vai sīkfailus.
- Word/HTML → EPUB e-grāmatas darba plūsmām.
Padoms: Izmantojiet PageSet, lai eksportētu konkrētus lapas vai rādītājus; apvienojiet ar ImageSaveOptions spirtiem vai miniatūrām.
Labākās prakses
- Licence first: pirms jebkādām konversijām uzsākt mērīto licencēšanu, lai izvairītos no novērtēšanas ūdensrādītājiem.
- Labāk plūsmas pakalpojumos, lai izslēgtu disku I/O un samazinātu latenci.
- Validēt agrāk: pārbaudiet maģiskus bītus vai mēģiniet sausā slodze ātri neveikt.
- Right-size output: izvēlieties jutīgu DPI, izvairieties no jebkura burta ievadīšanas, ja vien tas nav nepieciešams; izvēle PDF/A tikai tad, kad atbilstība ir nepieciešama.
- Resursu higiēna: iepakojums
Document
un plūsmas iekšāusing
Bloki ir. - Konkurence: lietošana īslaicīgi
Document
gadījumos pēc pieprasījuma; vajadzības gadījumā izmanto baseinus iespējām. - Apsveramība: log lapas skaitļi, ilgumi un opcijas; marķēt neveiksmes ar korelācijas ID.
FAQ
**Vai tas prasa Microsoft Office?**Nē, tas ir standalone API.
**Vai es varu konvertēt bez saskares ar failu sistēmu?**Visas konversijas var būt Stream → Stream.
**Kā es izpildīšu PDF/A?**Set PdfSaveOptions.Compliance = PdfCompliance.PdfA1b
(vai 2u) pirms ietaupīšanas.
**Vai es varu aizsargāt paroli PDF?**Jā. Konfigurēt šifrēšanu un atļauju zīmes PdfSaveOptions
.
**Vai Markdown round-trip ir drošs?**Tabulas, saraksti, virsrakstis, saites un inline formāts tiek atbalstīti ar tunable opcijas.
**Kā es konvertēju konkrētas lapas?**Use PageSet
Iekšējā ImageSaveOptions
vai FixedPageSaveOptions
‑atvasinātas klases.