Часто задаваемые вопросы
Лицензирование и открытый исходный код
Какова модель лицензирования для Aspose.Words FOSS для .NET?
Aspose.Words FOSS for .NET распространяется под лицензией MIT. Вы можете использовать его в личных, коммерческих и закрытых проектах бесплатно, без роялти и без необходимости ключа лицензии или активации во время выполнения — необходимо лишь сохранять уведомление об авторских правах и текст лицензии в любой копии программного обеспечения, которую вы распространяете.
Чем эта FOSS-версия отличается от коммерческого продукта Aspose.Words для .NET?
Aspose.Words FOSS для .NET не является переписыванием или обёрткой — это реальный Aspose.Words для исходного кода .NET, сокращённый до свободного, открытого ядра. Он предоставляет те же Document Object Model, что и коммерческий продукт (Document, DocumentBuilder, Section, Paragraph, Run, Table, и связанные классы), но исключает подсистему компоновки страниц и рендеринга, несколько устаревших и открытых форматов документов, выполнение слияния почты, LINQ Reporting, сравнение документов и подмножество встроенных шрифтов. Цифровые подписи можно проверять, но не создавать. См. вопросы о формате и ограничениях ниже для подробностей. Разработчики, которым нужен полный набор функций, могут использовать Aspose.Words for .NET вместе с этими открытыми ресурсами.
Установка и требования
Как установить Aspose.Words FOSS для .NET?
Библиотека доступна через NuGet или сборкой из исходного кода. Клонируйте репозиторий и соберите решение в конфигурации Release, затем добавьте ссылку на проект Aspose.Words.csproj из вашего собственного приложения:
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Какие версии .NET и операционные системы поддерживаются?
Библиотека нацелена на .NET Standard 2.0, поэтому работает на .NET Framework 4.6.2+ и .NET 6/8/10, на Windows, Linux и macOS. Это чисто управляемый C# без нативных зависимостей, поэтому не требуется устанавливать дополнительные системные пакеты.
Поддержка форматов
Какие файловые форматы может Aspose.Words FOSS для .NET читать и записывать?
| Формат | Load | Save |
|---|---|---|
| DOCX | Да | Да |
| DOCM | Да | Да |
| DOTX | Да | Да |
| DOTM | Да | Да |
| Flat OPC (плюс варианты с поддержкой макросов и шаблонов) | Да | Да |
| Markdown | Да | Да |
| Простой текст | Да | Да |
DOCX, DOCM, DOTX, DOTM и Flat OPC используют один и тот же считыватель/записыватель OOXML.
Могу ли я загрузить или сохранить файлы DOC, RTF, ODT, HTML или EPUB?
Нет. Список форматов в этом издании заканчивается на DOCX, DOCM, DOTX, DOTM, Flat OPC, Markdown и обычный текст — .doc, .rtf, .odt, .html и .epub находятся за пределами этого списка, и попытка открыть любой из таких файлов вызывает исключение.
Может ли Aspose.Words FOSS для .NET экспортировать документы в PDF, XPS или форматы изображений?
Нет. В этом издании нет подсистемы верстки и рендеринга, поэтому Document.Save() не может экспортировать в PDF, XPS или форматы изображений.
Сохраните вместо этого в DOCX, DOCM, DOTX, DOTM, Flat OPC, Markdown или обычный текст. Коммерческий Aspose.Words для .NET добавляет PDF, XPS и форматы изображений.
API Usage
Как создать новый документ?
Создайте Document, оберните его в DocumentBuilder и используйте высокоуровневые методы билдера для вставки содержимого перед сохранением:
using Aspose.Words;
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.Writeln("Hello, Aspose.Words FOSS!");
doc.Save("output.docx");Как загрузить существующий документ DOCX?
Передайте путь к файлу конструктору Document: new Document("input.docx"). Тот же конструктор также принимает Stream, и у обоих есть перегрузки, принимающие объект LoadOptions для более тонкой настройки того, как файл парсится.
Как обновляются поля, такие как DATE или DOCPROPERTY?
Aspose.Words FOSS for .NET включает полноценный движок оценки полей, поэтому поля содержимого, такие как DATE, DOCPROPERTY, REF, SEQ, и поля слияния почты обновляются программно. Поля, зависящие от макета страницы — например номера страниц в оглавлении — оцениваются как заполнитель 0 вместо вычисленного значения, потому что в этом издании отсутствует движок макета, который обычно разбивает документ на страницы.
Известные ограничения
Поддерживает ли это издание выполнение слияний почты, LINQ Reporting или сравнение документов?
Нет. Выполнение слияния почты, LINQ Reporting, сравнение документов и embedded-font subsetting не включены в это FOSS-издание. Классы, моделирующие настройки и поля слияния почты (например MailMergeSettings) присутствуют в объектной модели, но фактическое выполнение слияния не является частью этого издания.
Может ли Aspose.Words FOSS for .NET создать цифровую подпись в документе?
Нет. Это издание может просматривать и проверять цифровые подписи, уже прикреплённые к файлу .docx — через Document.DigitalSignatures, DigitalSignatureUtil.LoadSignatures() и классы DigitalSignature/DigitalSignatureCollection — но не может создавать новые подписи. Процесс подписи требует коммерческого Aspose.Words for .NET.
Поддерживается ли embedded-font subsetting?
Нет. Когда EmbedTrueTypeFonts включён, шрифты встраиваются как целые файлы, а не как подмножества, содержащие только глифы, действительно используемые в документе.