1. Продукты
  2.   Aspose.Words
  3.   Aspose.Words FOSS for .NET

Aspose.Words FOSS для .NET

Создавайте, читайте и редактируйте Word-документы из .NET — бесплатно и с открытым исходным кодом, построено на подлинном Aspose.Words-движке, Microsoft Word не требуется.

Aspose.Words FOSS for .NET Aspose.Words FOSS
for .NET

Документация GitHub

Open-Source .NET библиотека для Word документов

Aspose.Words FOSS for .NET — это библиотека под лицензией MIT, полностью написанная на C#, для работы с файлами Word .docx. Это не переписывание и не обёртка: это оригинальный Aspose.Words для исходного кода .NET, тот же движок документов, который обрабатывает Word-документы в продакшене с 2003 года, уменьшенный до бесплатного открытого ядра. Библиотека предоставляет тот же Document Object Model, используемый в коммерческом продукте — Document, DocumentBuilder, Section, Paragraph, Run, Table и сотни сопутствующих классов. Создавайте документы с нуля или открывайте существующие, манипулируйте текстом, таблицами, списками, стилями, колонтитулами, закладками, комментариями и сносками, а также преобразуйте между DOCX, Markdown и простым текстом. Включён полноценный движок вычисления полей, поэтому такие поля, как DATE, DOCPROPERTY и поля слияния почты, обновляются программно (поля, зависящие от разметки страниц, например номера страниц, возвращают заполнительные значения, поскольку разметка страниц не входит в эту редакцию). Библиотека ориентирована на .NET Standard 2.0, поэтому она работает на .NET Framework 4.6.2+, .NET 6/8/10, под Windows, Linux и macOS, без нативных зависимостей. Установите её через NuGet или соберите библиотеку из исходного кода (см. ниже). Разработчики, которым нужны корпоративные функции и поддержка в продакшене, могут использовать Aspose.Words for .NET — Enterprise Product вместе с этими open-source библиотеками.

Создание и редактирование документов

  • Создавать и открывать DOCX: Создавайте документы с нуля или загружайте существующие файлы .docx с помощью new Document() и new Document(path).
  • Авторинг высокого уровня: Используйте DocumentBuilder для вставки текста, перемещения курсора к разделам и закладкам, а также применения шрифтового, абзацного и форматирования страниц за несколько вызовов.
  • Полная объектная модель документа: Пройдитесь по дереву узлов напрямую или создайте подкласс DocumentVisitor для обработки каждого типа узлов.
  • Объединение и реорганизация: Добавляйте, клонируйте и импортируйте содержимое между документами, используя DocumentBuilder высокого уровня и API узлов.
  • Поиск и замена: Поиск/замена с поддержкой регулярных выражений и учётом форматирования по всему документу.

Где может использоваться Aspose.Words FOSS

  • Генерация документов: Создание отчетов, писем и контрактов из шаблонов без установленного Office.
  • Миграция контента: Чтение существующих файлов DOCX и их переработка, переоформление или извлечение содержимого.
  • Конвейеры конвертации форматов: Преобразование DOCX в Markdown или обычный текст для индексации поиска или генерации статических сайтов.
  • Безсерверные бэкенды: Обработка документов Word внутри Docker-контейнеров или облачных функций без COM-автоматизации.
  • Пакетная обработка документов: Применение одинаковых правок к большим коллекциям файлов DOCX.

Поля, таблицы и структура документа

  • Движок оценки полей: Обновляйте поля, такие как DATE, DOCPROPERTY, REF, SEQ и поля слияния почты, программно через полный движок полей.
  • Таблицы и условное форматирование: Создавайте и оформляйте таблицы с помощью Table/Row/Cell, включая условное форматирование по регионам через ConditionalStyle.
  • Списки: Создавайте, копируйте и получайте определения нумерованных и маркированных списков через ListCollection и ListFormat.
  • Отслеживаемые изменения: Просматривайте, принимайте или отклоняйте изменения с помощью RevisionCollection API.
  • Защита документа: Применяйте парольную защиту и принудительное только для чтения через перечисление DocumentSecurity.

Опыт разработчика

Aspose.Words FOSS — это чистый C#, ориентированный на .NET Standard 2.0 — без нативных расширений для компиляции, без системных пакетов для установки. Установите его через NuGet или соберите из исходного кода одной командой dotnet build.

API отражает коммерческий Aspose.Words для объектной модели .NET, поэтому официальная документация и примеры в значительной степени применимы к набору поддерживаемых функций этой версии. Он лицензирован по MIT и является открытым исходным кодом на GitHub.

Создать документ с диаграммой

Используйте DocumentBuilder.InsertChart(), чтобы добавить в документ форму диаграммы, затем получите объект Chart для настройки данных рядов. Очистите автоматически сгенерированные ряды перед добавлением реальных данных.

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

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[] `Chart`;
chart.Series.Add("AW Series 1", categories, new double[] { 4.3, 2.5, 3.5 });

doc.Save("chart.docx");

Часто задаваемые вопросы

Какова модель лицензирования для Aspose.Words FOSS for .NET?

Aspose.Words FOSS for .NET выпускается под лицензией MIT. Вы можете использовать его в личных, коммерческих и закрытых проектах бесплатно, без роялти и без необходимости ключа лицензии или шага активации во время выполнения.

Как установить Aspose.Words FOSS for .NET?

Установите его через NuGet, или соберите из исходного кода — клонируйте репозиторий, соберите решение в конфигурации Release, затем добавьте ссылку на проект Aspose.Words.csproj из вашего собственного приложения.

Какие форматы файлов может Aspose.Words FOSS for .NET читать и записывать?

DOCX, DOCM, DOTX, DOTM и Flat OPC (плюс его варианты с поддержкой макросов и шаблоны) для загрузки и сохранения, использующие один и тот же OOXML reader/writer, а также Markdown и обычный текст для загрузки и сохранения.

Может ли Aspose.Words FOSS for .NET экспортировать документы в PDF, XPS или форматы изображений?

Нет. Эта версия не включает подсистему верстки и рендеринга, поэтому Document.Save() не может экспортировать в PDF, XPS или форматы изображений. Сохраните в DOCX, DOCM, DOTX, DOTM, Flat OPC, Markdown или простой текст.

Может ли Aspose.Words FOSS for .NET создать цифровую подпись на документе?

Нет. Эта версия может просматривать и проверять цифровые подписи, уже вложенные в файл .docx, но не может создавать новые подписи. Рабочий процесс подписи требует коммерческого Aspose.Words для .NET.

Поддерживает ли это издание выполнение слияния писем, LINQ Reporting или сравнение документов?

Нет. Выполнение слияния почты, LINQ Reporting, сравнение документов и подмножество встроенных шрифтов не включены в эту FOSS-версию.

  

Ресурсы поддержки и обучения

 Русский