Aspose.Words Document Converter за .NET
Aspose.Words Document Converter for .NET је лагана, високе перформансе АПИ усредсређена на format-to-format конверзију. Подржава уобичајене сценарије као што су Word → PDF, HTML → pdf**, DOCX ↔ ODT* , * DOCX → Markdown** и PDF → слике (JPG/PNG/TIFF); и десетине више – без потребе за Microsoft Office.
Инсталација и подешавање
- Инсталирајте пакет НУГЕТ
Aspose.Words
(Основни АПИ снабдевање конверзије). - Аплицирајте мерене лиценце на стартапу како бисте избегли ограничења за процену: погледајте Метеран лиценцирање .
- Преглед оквирних захтева у Инсталацијски водич .
Подржане платформе
- ОС: Виндовс, Линук, МацОС
- Рамкови: .NET Framework 4.x, .net Standard 2.0, ,NET Core 2.0–3.1, .Net 5/6/7+, Mono
- ИДЕ: Визуел Студио 2017–2022, JetBrains Rider, MonoDevelop
брз почетак
1) Word → PDF (једна линија)
using Aspose.Words;
var doc = new Document("input.docx");
doc.Save("output.pdf");
2) ХТМЛ → ПДФ са опцијама
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) Доцкс → Маркдаун
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) ПДФ → слике (по страници)
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) Поток → поток (веб / сервис)
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");
}
Карактеристике и функционалност
Широк формат покривања
Унос / излаз (избрани):
- Слово породица: DOC, DOCX, DOT, RTF, WordML (XML)
- Фиксни распоред: ПДФ, ОТТ ФОРМАТ / ЕПУБ/)
Потпуна матрица се усклађује са Асписе.Вордс могућностима.Ако су присутни и **Филе Процесор ** плугин и овај Конвертер , можете прво преузети/редактирати, а затим извозити у жељеном формату.
Аутоматска детекција формата
АПИ открива формат из **главља датотека ** или проток садржаја , тако да можете безбедно прихватити произвољне преузимања у веб услугама.
Fine-Tuning sa Save Options
- PDF: PDF/A‐1b/2u, шифровање, дозвољене знаме, дигитални потписи, уграђивање шрифта, компресија слике.
- HTML/MHTML: Управљање ресурсима (унутра против споља), ЦСС режим, кодирање, формат слике и ДПИ.
- Слике: ДПИ, дубина боје, компресија, опсег страница, мулти-страница ТИФФ.
- Markdown: Списак и наслов стилови, табела усклађеност, генерација линкова.
Layout verodostojnosti i metadata
Сачува шрифтове, стилове, табеле, наслове / стопала, водене ознаке, коментаре, секције прекида, и документалне својства (аутор, заглавље, прилагођене поље.
Сервер-пријатељска обрада
- Стрејм-први АПИ, ниске распореде, буфер I/O.
- Async/batch конверзија и паралелизација за проток.
- Конфигурисане границе меморије и обраде страница за велике доцке.
Дијагноза и отпорност
Јасне изузеци о корумпираним/неподрженим улазама; хок у логинг/телеметрију да ухвати трајања, бројеве страница и разлоге за неуспех СЛА Tracking je.
Популарни рецепти за конверзију
- **DOCX → PDF/XPS ** за дистрибуцију и архивирање (опционално PDF/A).
- HTML → PDF за рачуне, изјаве и извештаје са конзистентним страницама.
- DOCX ↔ ODT za interoperabilnost u crossuitu.
- DOCX → Markdown за објављивање технолошких докова.
- PDF → PNG/JPEG/TIFF да бисте генерисали прегледе или слике.
- Word/HTML → EPUB za e-knjige radnih tokova.
Савет: Користите **PageSet ** да бисте извозили одређене странице или нијансе; комбинујте са ImageSaveOptions за спитре или мини.
Најбоља пракса
- Лиценца прво : Иницијалишете мерене лиценце пре било каквих конверзија како бисте избегли евалуацију водених знакова.
- Преферирају струје у услугама за прекидање диска И/О и смањење латенције.
- Рано валидисање : инспектирајте магичне бите или покушајте да суво оптерећење брзо не успе.
- **Право-величина излаза ** : изаберите осетљив ДПИ, избегавајте уграђивање сваког шрифта, осим ако је потребно; изаберете ПДФ/А само када је потребна поштовање.
- Хигијена ресурса : заваривање
Document
и струје уusing
и блоковима. - Конкурентна валута : краткотрајна употреба
Document
случајеви по захтеву; запошљавање базена за опције ако је потребно. - Обсервативност : бројеви страница, трајања и опције сетова; означивање неуспјеха са идентификаторима корелације.
FAQ
**Да ли је потребан Microsoft Office?**Не, то је самостална АПИ.
**Могу ли конвертовати без додирања датотеке?**Да. Све конверзије могу бити Stream → Stream.
**Како могу да извршим ПДФ/А?**сет PdfSaveOptions.Compliance = PdfCompliance.PdfA1b
(или 2у) пре него што спасите.
**Могу ли да заштитим ПДФ-а?**Da. Konfigurirajte šifriranje i dozvole zastave u PdfSaveOptions
.
**Да ли је Маркдаун кружни пут сигуран?**Комплексне распореде могу бити приближени. табеле, листе, наслови, линкови и форматирање у линији подржавају се тунибилним опцијама.
**Како могу да конвертујем одређене странице?**Коришћење PageSet
у ImageSaveOptions
или FixedPageSaveOptions
‑Одвојене класе.