ASPOSE.Words документ конвертор за .NET
Aspose.Words Document Converter за .NET е лек, високоефективен API, фокусиран върху format-to-format конверсия. Той поддържа общи сценарии като Word → PDF, HTML → pdf , DOCX ↔ ODT, DOCX → Markdown и десетки други – без да се изисква Microsoft Office.
Инсталация и инсталиране
- Инсталиране на пакета NuGet
Aspose.Words
(Основният API укрепва конвертирането). - Използване на мерни лицензии при стартиране, за да се избегнат границите на оценката: виж Размер на лицензията .
- Преглед на рамковите изисквания в Инсталационен ръководство .
Поддържани платформи
- Операционна система: Windows, Linux и MacOS
- Фреймъри: .NET Framework 4.x, .net Standard 2.0, ,NET Core 2.0–3.1, .Net 5/6/7+, Mono
- ИДЕ: Visual Studio 2017–2022, JetBrains Rider, MonoDevelop
Бързо стартиране
1) Word → PDF (една линия)
using Aspose.Words;
var doc = new Document("input.docx");
doc.Save("output.pdf");
2) HTML → PDF с опции
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 → Маркиране
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 → изображения (по страница)
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);
}
Продължаване на потока (web / service)
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");
}
Характеристики и функционалност
Широк формат покритие
Вход и изход (избрани):
- Семейство Word: DOC, DOCX, DOT, RTF, WordML (XML)
- Фиксирано оформление: PDF, Отт Форматът / EPUB/)
Пълната матрица е съвместима с възможностите на Aspose.Words. Ако и **File Processor ** и този Converter са налични, можете първо да изтеглите/редактирате и след това да експортирате в желания формат.
Автоматичен формат за откриване
API разкрива формат от **филмови заглавия ** или поток съдържание , така че можете безопасно да приемете произволни изтегляния в уеб услуги.
Fine-Tuning с опции за съхранение
- PDF: PDF/A‐1b/2u, шифроване, разрешителни знаме, цифрови подписи, вграждане на шрифтове, компресия на изображения.
- HTML/MHTML: управление на ресурсите (вътрешно vs. външно), CSS режим, кодиране, формат на изображението и DPI.
- Снимки: DPI, цветна дълбочина, компресия, диапазон на страници, мулти-страница TIFF.
- Markdown: списък и заглавни стилове, таблична хармонизация, генериране на връзки.
Изграждане на Fidelity & Metadata
Съхранява шрифтове, стилове, таблици, заглавия / стъпки, водометки, коментари, разкъсвания на секцията и документални свойства (автор, наслов, персонализирани полета.
сървърно-приятна обработка
- Първи поток АПИ, ниски разходи, буфер I/O.
- Async/batch конверсия и паралелизиране за пропуск.
- Конфигурираема памет и прагове за обработка на страници за големи докове.
Диагностика и устойчивост
Ясни изключения за корумпирани/неподпомагани вноски; хок в регистрация/телеметрия, за да се открият продължителности, страници и причини за неуспех СЛА за проследяване.
Популярни конвертирани рецепти
- **DOCX → PDF/XPS ** за разпространение и архивиране (опционално PDF/A).
- HTML → PDF за фактури, изявления и отчети с последователна страница.
- DOCX ↔ ODT за съвместимост на кръстосаната мрежа.
- DOCX → Markdown за публикуване на технологични документи.
- PDF → PNG/JPEG/TIFF за генериране на предварителни прегледи или миниатюри.
- Word/HTML → EPUB за работните потоци на електронни книги.
Съвет: Използвайте **PageSet ** , за да експортирате определени страници или диапазони; комбинирайте с ImageSaveOptions за спитове или миниатюри.
Най-добрите практики
- Лицензия първо : да започнете измерваното лицензиране преди всяка конверсия, за да избегнете оценяването на водните знаци.
- Предпочитат потоците в услугите, за да прекъснат I/O на диска и да намалят латенцията.
- Валидирайте рано : проверявайте магически байтове или се опитвайте да пропуснете бързо сухото натоварване.
- **Правилен изход ** : изберете чувствителен DPI, избягвайте да вграждате всеки шрифт, освен ако не е необходимо; Изберете PDF/A само когато се изисква съответствие.
- Хигиена на ресурсите : опаковка
Document
и потоците вusing
на блокове. - Конкурентна валута : краткотрайна употреба
Document
инстанции по искане; използвайте басейни за опции, ако е необходимо. - Забележка : броя на страниците, продължителността и опциите; етикетиране на неуспехи с идентификатори за корелация.
FAQ
**Трябва ли Microsoft Office?**Не, това е самостоятелна API.
**Мога ли да конвертирам без да докосвам файловата система?**Всички конверсии могат да бъдат Stream → Stream.
**Как мога да изпълня PDF/A?**сет PdfSaveOptions.Compliance = PdfCompliance.PdfA1b
(или 2u) преди да се спести.
**Мога ли да защитя паролата на PDF?**Да. Конфигуриране на шифроване и разрешителни знаме в PdfSaveOptions
.
**Безопасен ли е Маркдаун кръг-трип?**Табели, списъци, заглавия, връзки и инлайн форматиране могат да бъдат подпомагани с тънки опции.
**Как мога да конвертирам конкретни страници?**Използване PageSet
в ImageSaveOptions
или FixedPageSaveOptions
‑Деривати на класове.