Введение
Aspose.Words FOSS для .NET теперь доступен: бесплатная, с открытым исходным кодом библиотека .NET для создания, чтения и редактирования документов Word на чистом C#, без необходимости установки Microsoft Word. Она ориентирована на разработчиков, которым нужно генерировать отчёты и письма из шаблонов, читать и перестраивать содержимое из существующих файлов .docx, либо конвертировать документы Word в Markdown или обычный текст в рамках конвейера обработки, без лицензирования коммерческого SDK.
Библиотека распространяется под лицензией MIT и не имеет нативных зависимостей — всё работает в управляемом коде. Она нацелена на .NET Standard 2.0, поэтому работает на .NET Framework 4.6.2+ и .NET 6, 8 и 10, на Windows, Linux и macOS. Установите её через NuGet или соберите библиотеку из исходников одной командой dotnet build (см. быстрый старт ниже).
Что отличает её от типичной новой открытой библиотеки документов, так это то, что это не переписка и не обёртка. Aspose.Words FOSS для .NET — это подлинная кодовая база Aspose.Words — тот же движок документов, который обрабатывает Word-файлы в продакшене с 2003 года, сокращённый до бесплатного ядра под лицензией MIT. Разработчики, которым эта версия перестаёт хватать и которым нужны макет страниц, рендеринг или дополнительные конвертеры форматов, могут перейти на коммерческий Aspose.Words для .NET, не переписывая код, поскольку это тот же базовый API.
Ключевые возможности
Создание и редактирование документов
Создавайте документы с нуля с помощью new Document() и высокоуровневого DocumentBuilder, либо открывайте существующие файлы .docx с помощью new Document(fileName). DocumentBuilder предоставляет последовательные методы авторства, такие как Write(), Writeln(), InsertParagraph() и InsertBreak(), вместе с свойствами форматирования (Font, ParagraphFormat, PageSetup), которые применяются к содержимому при его вставке. Для доступа более низкого уровня обходите дерево документа напрямую через узлы Section, Paragraph, Run и Table, либо наследуйте DocumentVisitor для обработки всех типов узлов за один проход.
Таблицы и списки
Таблицы создаются из узлов Table, Row и Cell. Table.SetBorders(), Table.SetShading() и Table.AutoFit() форматируют всю таблицу сразу, тогда как доступ Table.Rows и построчный доступ Cell предоставляют более тонкий контроль. Нумерованные и маркированные списки проходят через ListCollection и ListFormat: примените встроенный стиль с помощью ListFormat.ApplyBulletDefault() или ApplyNumberDefault(), либо зарегистрируйте пользовательское определение списка с ListCollection.Add().
Отслеживаемые изменения и защита документа
Вызовите Document.StartTrackRevisions() до редактирования, чтобы фиксировать вставки, удаления и изменения форматирования, затем просмотрите, примите или отклоните их через RevisionCollection (AcceptAll(), RejectAll(), Accept(criteria), Reject(criteria)), либо примите всё сразу с помощью Document.AcceptAllRevisions(). Document.Protect() применяет защиту паролем или принудительное только-для-чтения с использованием перечисления DocumentSecurity (ReadOnlyEnforced, ReadOnlyRecommended, PasswordProtected и связанных значений), а Document.Unprotect() отменяет её.
Поля, макросы и цифровые подписи
Механизм оценки полей обновляет такие поля, как FieldDate (поле DATE) и FieldDocProperty (поле DOCPROPERTY) непосредственно через Document.UpdateFields() — поля, зависящие от разметки страницы, например номера страниц, оцениваются как значения-заполнители, поскольку разметка страницы не входит в эту редакцию. Файлы DOCM и DOTM проходят сквозной процесс с сохранёнными проектами VBA. Существующие цифровые подписи можно проверить через DigitalSignatureCollection и DigitalSignature (IsValid, SubjectName, IssuerName, SignTime), чтобы подтвердить, подписан ли документ и не был ли он изменён; создание новых подписей не входит в эту редакцию.
Диаграммы
Вставьте диаграмму в документ с помощью DocumentBuilder.InsertChart(), затем настройте её серии данных через возвращённый объект Chart.
using Aspose.Words;
using Aspose.Words.Drawing.Charts;
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape shape = builder.InsertChart(ChartType.Line, 432, 252);
Chart chart = shape.Chart;
// Delete default generated series.
chart.Series.Clear();
string[] categories = new string[] { "AW Category 1", "AW Category 2", "AW Category 3" };
chart.Series.Add("AW Series 1", categories, new double[] { 4.3, 2.5, 3.5 });
doc.Save("chart.docx");
Быстрый старт
Aspose.Words FOSS для .NET доступен через NuGet:
dotnet add package Aspose.Words.FOSSДля сборки из исходного кода:
git clone https://github.com/aspose-words-foss/Aspose.Words-FOSS-for-.NET.git
cd Aspose.Words-FOSS-for-.NET
dotnet build Aspose.Words.sln -c Release
Затем добавьте ссылку на проект Aspose.Words.csproj из вашего приложения. После того как ссылка добавлена, создайте документ с диаграммой и сохраните его в формате DOCX:
using Aspose.Words;
using Aspose.Words.Drawing.Charts;
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape shape = builder.InsertChart(ChartType.Line, 432, 252);
Chart chart = shape.Chart;
// Delete default generated series.
chart.Series.Clear();
string[] categories = new string[] { "AW Category 1", "AW Category 2", "AW Category 3" };
chart.Series.Add("AW Series 1", categories, new double[] { 4.3, 2.5, 3.5 });
doc.Save("chart.docx");
Console.WriteLine("Saved chart.docx");
Поддерживаемые форматы
| Формат | Расширение | Чтение | Запись |
|---|---|---|---|
| DOCX | .docx | ✓ | ✓ |
| DOCM | .docm | ✓ | ✓ |
| DOTX | .dotx | ✓ | ✓ |
| DOTM | .dotm | ✓ | ✓ |
| Flat OPC (все варианты) | (различные) | ✓ | ✓ |
| Markdown | .md | ✓ | ✓ |
| Text | .txt | ✓ | ✓ |
Это издание намеренно исключает верстку страниц и их рендеринг — нет экспорта в PDF, XPS или изображения, а также нет печати, что также означает, что значения полей, зависящие от макета, такие как номера страниц, остаются заполнителями, а не вычисляются. Дополнительные конвертеры форматов (DOC, RTF, ODT, HTML, EPUB, MHTML, MOBI, AZW3 и WordML) не поддерживают чтение и запись, а выполнение слияния почты, LINQ Reporting, сравнение документов, создание новых цифровых подписей и подмножество встроенных шрифтов не включены. Это те же подсистемы, которые были удалены из коммерческого кода, чтобы сделать данное издание бесплатным.
Открытый исходный код и лицензирование
Aspose.Words FOSS для .NET выпущен под лицензией MIT, бесплатно как для коммерческого, так и для личного использования, без роялти и ограничений на перераспространение. Полный исходный код доступен на GitHub в Aspose.Words FOSS для .NET репозитории.