Документирование релизов

Совет

Чтобы начать использовать SDK Documentize, у вас есть несколько вариантов загрузки бинарных файлов на вашу систему. Пожалуйста, выберите метод, который наилучшим образом соответствует вашим конкретным потребностям.

Внимание

Загружая SDK Documentize в любой форме, вы соглашаетесь с EULA Smallize.

Получить из NuGet

Самый простой способ начать работу с Documentize - установить пакет .NET напрямую из NuGet. Вот несколько быстрых методов для этого. Для получения более подробной информации посетите руководство по установке NuGet.

dotnet add package Documentize  
NuGet\Install-Package Documentize  
<PackageReference Include="Documentize" Version="24.x.x" />  

Скачать MSI установщик

Еще один вариант получения Documentize - это загрузка MSI пакета, который устанавливает необходимые сборки (DLL). Просто нажмите на следующую кнопку загрузки или узнайте больше об этом методе установки в руководстве по установке MSI.

Скачать последнюю версиюv25.7 MSI

Скачать ZIP

Вы также можете загрузить ZIP пакет, содержащий только файлы DLL, которые вы можете сохранить любым удобным для вас способом. Узнайте больше об этом в руководстве по установке ZIP.

Скачать последнюю версиюv25.7 ZIP
28 дек. 2024 г.

Подразделы Документирование релизов

О Documentize

Что такое Documentize?

Documentize — это мощный компонент .NET, который позволяет разработчикам программно создавать профессиональные и универсальные PDF-документы, устраняя необходимость в сторонних инструментах, таких как Adobe Acrobat.

Почему стоит использовать Documentize?

Вот почему Documentize выделяется среди других:

  • Легкое создание PDF: Генерируйте простые или сложные PDF-документы на лету, включая такие элементы, как таблицы, графики, изображения, гиперссылки и пользовательские шрифты.
  • Улучшенная безопасность: Интегрируйте надежные функции безопасности для защиты ваших конфиденциальных PDF-документов.
  • Гибкие варианты разработки: Выбирайте между созданием PDF с помощью удобного API или XML-шаблонов для упрощения рабочего процесса.
  • Упрощенная интеграция: Documentize бесшовно интегрируется с различными приложениями .NET, включая веб-приложения ASP.NET и настольные приложения на таких языках, как C#, VB.NET и J#.
  • Быстрота и эффективность: Легковесный компонент эффективно генерирует PDF, оптимизируя производительность вашего приложения.
  • Экономически эффективный и поддерживаемый: Наслаждайтесь конкурентоспособной ценой, исключительной производительностью и всесторонней поддержкой для гладкого процесса разработки.

Ключевые особенности

  • Поддержка разнообразного контента: Добавляйте таблицы, графики, изображения, гиперссылки, пользовательские шрифты и многое другое в ваши PDF-документы.
  • Возможности сжатия: Уменьшите размер файла ваших PDF-документов для более легкого хранения и распределения.
  • Расширенная безопасность: Реализуйте функции безопасности для защиты конфиденциальной информации в ваших PDF-документах.
  • Два метода создания: Создавайте PDF-документы с помощью программного API или XML-шаблонов для дополнительной гибкости.
  • Кроссплатформенная совместимость: Работает бесшовно с различными языками и типами приложений .NET.
  • Поддержка многопоточности: Позволяет безопасно создавать несколько PDF-документов одновременно в разных потоках.
  • Ресурсы для обучения: Получите доступ к обширным демонстрациям и рабочим примерам на C#, чтобы ускорить ваш процесс разработки.

Идеальный выбор для различных отраслей

Documentize обслуживает широкий спектр отраслей, в которых генерирование PDF-документов играет ключевую роль. К ним относятся:

  • Финансовый сектор и бухгалтерия: Генерируйте счета, квитанции, финансовые отчеты и другие важные документы.
  • Здравоохранение: Создавайте медицинские записи, рецепты и лабораторные отчеты в безопасном и стандартизированном формате.
  • Производство: Производите технические спецификации продукции, отчеты по контролю качества и транспортные документы.
  • Государственный и юридический сектор: Генерируйте разрешения, лицензии, контракты и судебные документы с улучшенными функциями безопасности.
  • Образование: Создавайте сертификаты, транскрипты, отчеты и другие академические документы.

Documentize помогает разработчикам из различных отраслей оптимизировать свои рабочие процессы создания PDF, обеспечивая эффективность, безопасность и гибкость.

28 дек. 2024 г.

Оценка

Оценка Documentize для .NET

Вы можете легко скачать Documentize для .NET для оценки. Загрузке для оценки соответствует загрузка, которую вы покупаете. Оценочная версия просто становится лицензированной, когда вы добавляете несколько строк кода для применения лицензии.

Оценочная версия Documentize (без указанной лицензии) предоставляет полную функциональность продукта, но имеет два ограничения: она вставляет водяной знак оценки, и только четыре элемента любой коллекции могут быть просмотрены/отредактированы.

Если вы хотите протестировать Documentize для .NET без ограничений оценочной версии, вы также можете запросить временную лицензии на 30 дней. Пожалуйста, обратитесь к Как получить временную лицензию?

28 дек. 2024 г.

Установка

Установка SDK Documentize

Documentize можно установить несколькими способами, каждый из которых адаптирован к различным средам разработки и предпочтениям. Ниже приведены рекомендуемые способы установки Documentize:

1. NuGet (Предпочтительный метод)

NuGet — это самый простой и предпочтительный способ установки Documentize, который обеспечивает наличие последней версии и обновлений прямо в вашей среде разработки. Дополнительные детали о данном методе установки можно найти в Как установить SDK Documentize с помощью NuGet.

2. MSI Установщик

MSI установщик является удобным вариантом, если вы предпочитаете, чтобы DLL-файлы Documentize были установлены непосредственно на ваш компьютер. Этот метод идеален для разработчиков, которые могут захотеть использовать Documentize в нескольких проектах без необходимости вручную управлять файлами DLL. Дополнительные детали о данном методе установки можно найти в Как установить SDK Documentize с помощью MSI.

3. ZIP Архив

Для разработчиков, предпочитающих ручной подход, ZIP архив содержит DLL-файлы Documentize, которые можно извлечь и добавить в ваш проект напрямую. Дополнительные детали о данном методе установки можно найти в Как установить SDK Documentize с помощью ZIP.

28 дек. 2024 г.

Подразделы Установка

Установка Documentize через NuGet


Совет

NuGet — это бесплатный менеджер пакетов с открытым исходным кодом для .NET, который упрощает добавление, удаление и обновление библиотек в проектах Visual Studio. Он автоматически управляет файлами библиотек, ссылками и изменениями конфигурации.

Как установить через консоль менеджера пакетов NuGet

  1. Откройте свой проект:

    • Запустите Visual Studio и откройте свое .NET приложение.
  2. Доступ к консоли менеджера пакетов:

    • Перейдите в Справка > Менеджер пакетов NuGet > Консоль менеджера пакетов.
  3. Установите пакет:

    • Чтобы установить последнюю полную версию, введите команду Install-Package Documentize.
    • Чтобы установить последнюю версию, включая исправления, используйте Install-Package Documentize -prerelease.
    • Нажмите Enter, чтобы выполнить команду.

Как обновить пакет через консоль менеджера пакетов NuGet

Если вы уже установили Documentize через NuGet и хотите обновить до последней версии:

  1. Откройте свой проект:

    • Запустите Visual Studio и откройте свое .NET приложение.
  2. Доступ к консоли менеджера пакетов:

    • Перейдите в Справка > Менеджер пакетов NuGet > Консоль менеджера пакетов.
  3. Обновите пакет:

    • Чтобы обновить до последней полной версии, введите Update-Package Documentize.
    • Чтобы обновить до последней версии, включая исправления, используйте Update-Package Documentize -prerelease.
    • Нажмите Enter, чтобы выполнить команду.

Как установить через графический интерфейс менеджера пакетов NuGet

  1. Откройте свой проект:

    • Запустите Visual Studio и откройте свое .NET приложение.
  2. Перейдите к управлению пакетами NuGet:

    • В меню Проект выберите Управление пакетами NuGet.
  3. Найдите Documentize:

    • Перейдите на вкладку Обзор и введите Documentize в строку поиска.
  4. Установите пакет:

    • Нажмите Установить/Обновить рядом с последней версией Documentize.
    • Подтвердите, нажав Принять в появившемся окне.

Плюсы использования NuGet

  • Автоматическое управление зависимостями:

    • NuGet автоматически управляет зависимостями, обеспечивая правильное включение и обновление всех необходимых библиотек. Это снижает риск отсутствия или несовместимости зависимостей.
  • Упрощенные обновления:

    • Обновление пакетов с помощью NuGet довольно простое, как через консоль менеджера пакетов, так и через графический интерфейс. Это упрощает поддержку ваших библиотек в актуальном состоянии с последними возможностями и исправлениями.
  • Интеграция с Visual Studio:

    • NuGet бесшовно интегрирован с Visual Studio, предоставляя удобный интерфейс для управления пакетами, не покидая среду разработки.
  • Версионирование:

    • NuGet позволяет указывать и управлять различными версиями библиотек, что позволяет легко возвращаться к предыдущим версиям или тестировать новые релизы без нарушения процесса разработки.

Минусы использования NuGet

  • Ограничено Visual Studio:

    • NuGet в первую очередь разработан для использования в Visual Studio. Хотя его можно использовать в других средах, интеграция наиболее robust в Visual Studio.
  • Потенциальные конфликты версий:

    • В крупных проектах с множеством зависимостей управление версиями и разрешение конфликтов могут стать сложными. NuGet предоставляет инструменты для управления этим, но это требует внимательного подхода.
  • Зависимость от сети:

    • Установка и обновление пакетов требуют подключения к интернету. Если вы работаете в среде с ограниченным или отсутствующим интернет-доступом, вам, возможно, придется использовать оффлайн-методы или заранее загрузить пакеты.
  • Сложность для крупных проектов:

    • Для очень крупных проектов с расширенными деревьями зависимостей управление пакетами через NuGet может стать обременительным. В таких случаях могут потребоваться дополнительные инструменты или стратегии для эффективного управления зависимостями.

Установка Documentize с помощью MSI

Совет

MSI-установщик - это удобный и простой способ установки Documentize, особенно если вы предпочитаете, чтобы DLL-файлы были установлены в системе. Этот метод упрощает процесс установки, автоматизируя многие шаги.

Как установить с помощью MSI-установщика

  1. Скачайте MSI-установщик:

    • Нажмите на v25.7 MSI, чтобы скачать MSI-установщик последней версии Documentize.
  2. Запустите установщик:

    • Дважды щелкните на загруженный MSI-файл, чтобы открыть мастер установки.
  3. Следуйте инструкциям мастера установки:

    • Следуйте указаниям на экране, предоставленным установщиком. Возможно, вам потребуется согласиться на лицензионное соглашение и выбрать параметры установки.
  4. Завершите установку:

    • После завершения установки DLL-файлы Documentize будут установлены в глобальный кэш сборок (GAC) вашей системы или в другое указанное место.
  5. Проверьте установку:

    • Убедитесь, что DLL-файлы установлены корректно, проверив их наличие в указанной директории установки или GAC.

Плюсы использования MSI-установщика

  • Простота использования:

    • MSI-установщик предоставляет простой и понятный процесс установки. Он обрабатывает все необходимые настройки и размещает DLL-файлы в централизованном месте, что упрощает использование Documentize в нескольких проектах.
  • Установка на уровне системы:

    • Метод MSI устанавливает Documentize в глобальный кэш сборок (GAC) системы или другое центральное место. Это позволяет любому приложению в системе обращаться к DLL-файлам без необходимости указывать их отдельно в каждом проекте.
  • Автоматические обновления:

    • Если Documentize предоставляет обновленный установщик, вы можете легко обновить свою установку, запустив новый MSI-файл, который обычно обрабатывает процесс обновления гладко.
  • Согласованность:

    • Использование MSI-установщика гарантирует, что все необходимые файлы установлены корректно и согласованно в разных средах, уменьшая риск отсутствующих или неправильно размещенных DLL-файлов.

Минусы использования MSI-установщика

  • Ограниченная гибкость:

    • MSI-установщик устанавливает Documentize в системное место, что может быть не подходящим для всех сред разработки. Ему может не хватать гибкости для учета конфигураций или версий, специфичных для проекта.
  • Потенциальные накладные расходы:

    • Установка DLL-файлов в GAC может ввести накладные расходы и сложность, особенно в сценариях, когда одновременно могут потребоваться несколько версий Documentize.
  • Ручное удаление:

    • Если вам нужно удалить Documentize, вы должны использовать средство удаления, предоставляемое MSI, которое может оставить остаточные файлы или конфигурации, если не будет правильно управляться.
  • Конфликты версий:

    • Установки на уровне системы могут привести к конфликтам версий, если разные проекты требуют различных версий Documentize. Управление этими конфликтами может потребовать дополнительной настройки или очистки.

Установка Documentize через ZIP

Совет

ZIP-архив идеален для разработчиков, предпочитающих ручной подход к управлению библиотеками. Этот метод позволяет вам напрямую загружать и распаковывать необходимые файлы DLL без зависимости от менеджера пакетов или установщика.

Как установить через ZIP-архив

  1. Скачать ZIP-архив:

    • Нажмите на v25.7 ZIP, чтобы скачать последнюю версию Documentize в архивном формате.
  2. Извлечь содержимое:

    • После загрузки распакуйте содержимое ZIP-файла в каталог по вашему выбору. Вы можете выбрать, сохранить эти файлы в общем каталоге или внутри структуры вашего проекта.
  3. Добавить ссылки на ваш проект:

    • Откройте ваш проект в вашей IDE (например, Visual Studio).
    • Перейдите в Проект > Добавить ссылку > Обзор и перейдите в каталог, где вы извлекли DLL-файлы.
    • Выберите соответствующие DLL-файлы и добавьте их в качестве ссылок на ваш проект.
  4. Ручные обновления:

    • Если новая версия Documentize будет выпущена, вам нужно будет вручную скачать обновленный ZIP-архив и заменить старые DLL-файлы в вашем проекте на новые.

Плюсы использования ZIP-архива

  • Полный контроль:

    • У вас есть полный контроль над тем, где и как DLL-файлы хранятся и ссылаются в вашем проекте. Это может быть полезно, если вы предпочитаете индивидуальную настройку или вам нужно управлять зависимостями вручную.
  • Нет зависимости от менеджеров пакетов:

    • В отличие от NuGet, вы не зависите от менеджера пакетов для обработки установок. Это может быть выгодно в средах, где менеджеры пакетов недоступны или нежелательны.
  • Портативность:

    • ZIP-архив можно легко передавать и перемещать между различными системами, что делает его идеальным для проектов, которые должны быть портативными или распространяемыми без зависимости от внешних инструментов.

Минусы использования ZIP-архива

  • Ручное управление:

    • В отличие от NuGet, где обновления и управление зависимостями автоматизированы, с ZIP-архивом вам необходимо вручную управлять обновлениями и следить за тем, чтобы все необходимые DLL были правильно подключены.
  • Риск конфликтов версий:

    • Если вы управляете несколькими проектами или работаете в команде, существует риск конфликтов версий, если разные проекты используют разные версии DLL. Это требует тщательного отслеживания версий между проектами.
  • Нет автоматических обновлений:

    • Вы не получите автоматических обновлений или уведомлений, когда будет доступна новая версия. Это может привести к использованию устаревших библиотек, если вы не будете регулярно проверять наличие обновлений.

Невиндоусная среда

Работа с .NET Core DLL в невиндоусной среде

Поскольку Documentize для .NET поддерживает .NET Standard 2.0 ( .NET Core 2.0), его можно использовать в ядре приложений, работающих в операционных системах, подобных Linux. Мы постоянно работаем над улучшением поддержки .NET Core в нашем API. Тем не менее, есть некоторые операции, которые мы рекомендуем нашим клиентам выполнять, чтобы добиться лучших результатов при использовании функций Documentize для .NET. Пожалуйста, установите:

  • пакет libgdiplus
  • пакет с шрифтами, совместимыми с Microsoft: ttf-mscorefonts-installer (например, sudo apt-get install ttf-mscorefonts-installer). Эти шрифты должны быть размещены в директории /usr/share/fonts/truetype/msttcorefonts, так как Documentize для .NET сканирует эту папку в операционных системах, подобных Linux. В случае, если операционная система имеет другую папку/директорию по умолчанию для шрифтов, вы должны использовать следующую строку кода перед выполнением любой операции с использованием Documentize:
    Documentize.Pdf.Text.FontRepository.Sources.Add(new FolderFontSource("<путь пользователя к шрифтам ms>"));

Что нового

v25.7

  • Улучшенная удобству использования Text Extractor
  • Улучшенная удобству использования Html Converter
  • Улучшенная удобству использования Image Extractor

v25.6

  • Улучшенная удобство использования Tiff Converter

v25.5

  • Добавлен новый плагин: Form Exporter
  • Улучшена удобство использования Security

v25.4

  • Улучшенная удобочитаемость Optimizer
  • Улучшенная удобочитаемость Plugin Splitter
  • Улучшенная удобочитаемость Plugin Merger

v25.3

  • Добавлен новый плагин: Form Flattener

v25.2

  • Добавлен новый плагин: Генератор содержания

v25.1

  • Улучшенный плагин: ImageExtractor

v24.12

  • Добавлен новый плагин: Конвертер PDF в PNG
  • Добавлен новый плагин: Конвертер PDF в TIFF
  • Добавлен новый плагин: Генератор таблиц PDF
  • Переименован класс PdfDoc в DocConverter

v24.11

  • Добавлен новый плагин: Конвертер PDF в JPEG
  • Добавлен класс DirectoryDataSource
  • Добавлен класс PdfToJpegOptions

v24.10

  • Добавлен новый плагин: PDF/A Конвертер

v24.9

  • Выпущено
10 окт. 2024 г.

Подразделы Что нового

v25.7

Улучшенная удобству использования Text Extractor

  • Class TextExtractor: статичен и не требует использования конструктора.
  • Class TextExtractor: улучшено поведение при работе в режиме оценки. Нет исключения при работе с документами на 4+ страницах.
  • Class TextExtractor: исправлены ошибки в методе Process.
  • Class PdfExtractorOptions: удалён.
  • Class TextExtractorOptions: переработан.
  • Enum TextFormattingMode: переименован и улучшен.

Пример использования:

// Пример демонстрирует, как извлечь текстовое содержимое PDF документа.
// Создайте объект TextExtractorOptions для установки инструкций
var options = new TextExtractorOptions(TextFormattingMode.Pure);
// Добавьте путь к входному файлу
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Выполните процесс
var results = TextExtractor.Process(options);
// Получите извлечённый текст из объекта ResultContainer
var textExtracted = results.ResultCollection[0].ToString();

Улучшенная удобству использования Html Converter

  • Class HtmlConverter: статичен и не требует использования конструктора.
  • Class HtmlConverter: исправлены ошибки в методе Process.
  • Class HtmlConverter: удалена логика IDisposable.
  • Class PdfConverterOptions: удалён.

Примеры использования:

// Пример демонстрирует, как конвертировать PDF в HTML документ.
// Создайте объект PdfToHtmlOptions, чтобы установить тип выходных данных как файл с встроенными ресурсами
var options = new PdfToHtmlOptions(PdfToHtmlOptions.SaveDataType.FileWithEmbeddedResources);
// Добавьте путь к входному файлу
options.AddInput(new FileDataSource("path_to_input.pdf"));
// Установите путь к выходному файлу
options.AddOutput(new FileDataSource("path_to_output.html"));
// Выполните процесс
HtmlConverter.Process(options);

// Пример демонстрирует, как конвертировать HTML в PDF документ.
// Создайте HtmlToPdfOptions
var options = new HtmlToPdfOptions();
// Добавьте путь к входному файлу
options.AddInput(new FileDataSource("path_to_input.html"));
// Установите путь к выходному файлу
options.AddOutput(new FileDataSource("path_to_output.pdf"));
// Выполните процесс
HtmlConverter.Process(options);

Улучшенная удобству использования Image Extractor

  • Class ImageExtractor: статичен и не требует использования конструктора.

Пример использования:

// Пример демонстрирует, как извлечь изображения из PDF документа.
// Создайте ImageExtractorOptions для установки инструкций
var options = new ImageExtractorOptions();
// Добавьте путь к входному файлу
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Установите путь к выходному каталогу
options.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// Выполните процесс
var results = ImageExtractor.Process(options);
// Получите путь к результату изображения
var imageExtracted = results.ResultCollection[0].ToFile();

Небольшие исправления

  • Внутренние исправления.
  • Исправлены примеры и подсказки Tiff Converter.
  • Сокращено время оптимизации страниц.
  • Исправлено: неправильный вывод изображения при конвертации PDF в PNG.
  • Исправлено: китайские символы отображаются неправильно при конвертации PDF в PNG.
  • Улучшено: производительность при конвертации PDF в HTML.
10 июл. 2025 г.

v25.6

Улучшенная удобство использования Tiff Converter

  • Класс PdfToTiffOptions: Добавлен дополнительный параметр для конверсии - Сжатие.
  • Класс PdfToTiffOptions: Добавлен дополнительный параметр для конверсии - Глубина цвета.
  • Класс TiffConverter статичен и не требует использования конструктора.
  • Улучшены основные примеры.

Примеры использования:

// Этот пример демонстрирует, как конвертировать документ PDF в формат TIFF.
// Создайте объект PdfToTiffOptions, чтобы установить инструкции
var options = new PdfToTiffOptions();
// Добавьте путь к входному файлу
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Установите путь к выходному каталогу
options.AddOutput(new DirectoryDataSource("path_to_output_directory"));
// Выполните процесс
TiffConverter.Process(options);

// Этот пример демонстрирует, как конвертировать документ PDF в формат TIFF с дополнительными параметрами.
// Создайте объект PdfToTiffOptions, чтобы установить инструкции
var options = new PdfToTiffOptions();
// Добавьте путь к входному файлу
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Установите путь к выходному каталогу
options.AddOutput(new DirectoryDataSource("path_to_output_directory"));
// Необязательные параметры
options.PageList = new List<int> { 1, 3 };
options.MultiPage = true;
options.OutputResolution = 400;
options.Compression = TiffCompression.RLE;
options.ColorDepth = TiffColorDepth.Format24bpp;
// Выполните процесс
TiffConverter.Process(options);

Небольшие исправления

  • Внутренние исправления.
10 июл. 2025 г.

v25.5

Добавлен новый плагин: Form Exporter

  • Класс FormExporter: Представляет плагин Documentize.FormExporter, который используется для экспорта значений форм PDF документов в файл DSV или CSV.
  • Класс FormExportToDsvOptions: Представляет параметры для экспорта значений PDF документов в файл DSV или CSV с помощью плагина Documentize.FormExporter.

Пример использования:

// Пример демонстрирует, как экспортировать значения формы в файл CSV.
// Создайте объект FormExportToDsvOptions, чтобы установить инструкции
var options = new FormExportToDsvOptions(',', true);
// Добавьте путь к входному файлу
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Установите путь к выходному файлу
options.AddOutput(new FileDataSource("path_to_result_csv_file.csv"));
// Выполните процесс
FormExporter.Process(options);

Улучшена удобство использования Security

  • Класс статический и не требует использования конструктора.
  • Улучшены основные примеры.

Примеры использования:

// Пример демонстрирует, как зашифровать PDF документ.
// Создайте объект EncryptionOptions, чтобы установить инструкции
var options = new EncryptionOptions("123456", "qwerty");
// Добавьте путь к входному файлу
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Установите путь к выходному файлу
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// Выполните процесс
Security.Process(options);

// Пример демонстрирует, как расшифровать PDF документ.
// Создайте объект DecryptionOptions, чтобы установить инструкции
var options = new DecryptionOptions("123456");
// Добавьте путь к входному файлу
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Установите путь к выходному файлу
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// Выполните процесс
Security.Process(options);

Небольшие исправления

  • Улучшены подсказки по классам и лицензиям.
10 июл. 2025 г.

v25.4

Улучшенная удобочитаемость Optimizer

  • Класс статический и не требует использования конструктора.
  • Улучшен основной пример.
  • Добавлены дополнительные примеры.

Примеры использования:

// Пример демонстрирует, как оптимизировать PDF документ.
// Создайте объект OptimizeOptions для установки инструкций
var options = new OptimizeOptions();
// Добавьте путь к входному файлу
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Установите путь к выходному файлу
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// Выполните процесс
Optimizer.Process(options);

// Пример демонстрирует, как повернуть PDF документ.
// Создайте объект RotateOptions для установки инструкций
var options = new RotateOptions();
// Установите новое вращение
options.Rotation = Rotation.On90;
// Добавьте путь к входному файлу
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Установите путь к выходному файлу
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// Выполните процесс
Optimizer.Process(options);

// Пример демонстрирует, как изменить размер PDF документа.
// Создайте объект ResizeOptions для установки инструкций
var options = new ResizeOptions();
// Установите новый размер страницы
options.PageSize = PageSize.A3;
// Добавьте путь к входному файлу
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Установите путь к выходному файлу
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// Выполните процесс
Optimizer.Process(options);

// Пример демонстрирует, как сжать PDF документ.
// Создайте объект CompressOptions для установки инструкций
var options = new CompressOptions();
// Добавьте путь к входному файлу
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Установите путь к выходному файлу
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// Выполните процесс
Optimizer.Process(options);

Улучшенная удобочитаемость Plugin Splitter

  • Класс статический и не требует использования конструктора.
  • Улучшен основной пример.

Примеры использования:

// Пример демонстрирует, как разделить PDF документ.
// Создайте объект SplitOptions для установки инструкций
var options = new SplitOptions();
// Добавьте путь к входному файлу
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Установите пути к выходным файлам
options.AddOutput(new FileDataSource("path_to_result_pdf_file_1.pdf"));
options.AddOutput(new FileDataSource("path_to_result_pdf_file_2.pdf"));
// Выполните процесс
Splitter.Process(options);

Улучшенная удобочитаемость Plugin Merger

  • Класс статический и не требует использования конструктора.
  • Улучшен основной пример.

Примеры использования:

// Пример демонстрирует, как объединить два PDF документа.
// Создайте объект MergeOptions для установки инструкций
var options = new MergeOptions();
// Добавьте пути к входным файлам
options.AddInput(new FileDataSource("path_to_your_pdf_file_1.pdf"));
options.AddInput(new FileDataSource("path_to_your_pdf_file_2.pdf"));
// Установите путь к выходному файлу
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// Выполните процесс
Merger.Process(options);

Мелкие исправления

  • Улучшены подсказки классов.
10 июл. 2025 г.

v25.3

Добавлен новый плагин: Form Flattener

  • Class FormFlattener: Представляет плагин Documentize.FormFlattener, который используется для преобразования полей в PDF-документах.
  • Class FormFlattenerOptions: Представляет параметры для преобразования полей в документе с помощью плагина Documentize.FormFlattener.

Пример использования:

//Данный пример демонстрирует, как преобразовать поля в PDF-файле.
// Создайте объект FormFlattenerOptions для установки инструкций
var options = new FormFlattenerOptions();
// Добавьте путь к входному файлу
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Установите путь к выходному файлу
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
//Необязательный параметр для пропуска поля с именем "Surname".
options.SkipFields.Add("Surname");
// Выполнить процесс
FormFlattener.Process(options);

//Данный пример демонстрирует, как получить имена полей из PDF-файла.
var fieldNames = FormFlattener.GetFieldNames("path_to_your_pdf_file.pdf");

Небольшие исправления

  • Улучшены подсказки классов и примеры.
10 июл. 2025 г.

v25.2

Добавлен новый плагин: Генератор содержания

  • Class TocGenerator: Представляет плагин Documentize.TocGenerator. Используется для добавления оглавления в PDF документы.
  • Class TocOptions: Представляет параметры для добавления оглавления в документ с помощью плагина Documentize.TocGenerator.
  • Class TocHeading: Представляет параметры для заголовков или названий оглавления документа с помощью плагина Documentize.TocGenerator.

Пример использования:

// Пример демонстрирует, как добавить оглавление в PDF файл.
var options = new TocOptions();
// Установить заголовок
options.Title = "Мое оглавление";
// Генерировать ссылки в закладках
options.GenerateBookmarks = true;
// Дизайн заголовков
options.Headings.Add(new TocHeading("Введение", 2, false, 1));
options.Headings.Add(new TocHeading("Глава I", 3, true, 1));
options.Headings.Add(new TocHeading("Глава II", 4, true, 1));
options.Headings.Add(new TocHeading("Пример A", 4, true, 2));
options.Headings.Add(new TocHeading("Пример B", 4, true, 2));
options.Headings.Add(new TocHeading("Пример C", 4, true, 2));
options.Headings.Add(new TocHeading("Пример D", 4, true, 2));
options.Headings.Add(new TocHeading("Глава III", 5, true, 1));
// Добавить путь к входному файлу
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Установить путь к выходному файлу
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// Выполнить процесс
TocGenerator.Process(options);

Небольшие исправления

  • Улучшены подсказки и примеры классов.
  • Обновлены водяные знаки.
  • Улучшена конверсия PDF в XSLX.
  • Улучшена конверсия PDF в PDF/A-1a.
10 июл. 2025 г.

v25.1

Улучшенный плагин: ImageExtractor

  • Добавлено коллекция выходных данных в ImageExtractorOptions.
  • Добавлена поддержка нескольких входов в ImageExtractorOptions.
  • Исправлены закрытые выходные потоки.

Пример использования:

// создать объект ImageExtractor для извлечения изображений
var plugin = new ImageExtractor();
// создать ImageExtractorOptions
var opt = new ImageExtractorOptions();
// добавить путь к входному файлу
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// установить выходной каталог
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// выполнить процесс извлечения
var resultContainer = plugin.Process(opt);
// получить изображение из объекта ResultContainer
var imageExtracted = resultContainer.ResultCollection[0].ToFile();

Небольшие исправления

  • Улучшены подсказки и примеры классов.
  • Валидация подписи PDF.
  • Улучшена поддержка китайских символов.
10 июл. 2025 г.

v24.12

Добавлен новый плагин: Конвертер PDF в PNG

  • Класс PngConverter: Представляет плагин Documentize.PngConverter. Используется для конвертации PDF-документов в формат PNG.
  • Класс PdfToPngOptions: Представляет параметры конвертации PDF в PNG для плагина Documentize.PngConverter.

Пример использования:

// создать PngConverter
var plugin = new PngConverter();
// создать объект PdfToPngOptions для установки инструкций
var opt = new PdfToPngOptions();
// добавить путь к входному файлу
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// установить путь к выходному файлу
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// выполнить процесс
plugin.Process(opt);

Добавлен новый плагин: Конвертер PDF в TIFF

  • Класс TiffConverter: Представляет плагин Documentize.TiffConverter. Используется для конвертации PDF-документов в формат TIFF.
  • Класс PdfToTiffOptions: Представляет параметры конвертации PDF в TIFF для плагина Documentize.TiffConverter.

Пример использования:

// создать TiffConverter
var plugin = new TiffConverter();
// создать объект PdfToTiffOptions для установки инструкций
var opt = new PdfToTiffOptions();
// добавить путь к входному файлу
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// установить путь к выходному файлу
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// выполнить процесс
plugin.Process(opt);

Добавлен новый плагин: Генератор таблиц PDF

  • Класс TableGenerator: Представляет плагин Documentize.TableGenerator. Используется для добавления таблицы в PDF-документ.
  • Класс TableBuilder: Класс представляет построитель таблицы на странице PDF.
  • Класс TableRowBuilder: Класс представляет построитель строки таблицы.
  • Класс TableCellBuilder: Класс представляет построитель ячейки таблицы.

Пример использования:

// создать TableGenerator
var plugin = new TableGenerator();
// создать объект TableOptions для установки инструкций
TableOptions opt = new TableOptions().InsertPageBefore(1)
   .AddTable()
        .AddRow()
            .AddCell().AddParagraph("Имя")
            .AddCell().AddParagraph("Возраст")
        .AddRow()
            .AddCell().AddParagraph("Боб")
            .AddCell().AddParagraph("12")
        .AddRow()
            .AddCell().AddParagraph("Сэм")
            .AddCell().AddParagraph("20")
        .AddRow()
            .AddCell().AddParagraph("Сэнди")
            .AddCell().AddParagraph("26")
        .AddRow()
            .AddCell().AddParagraph("Том")
            .AddCell().AddParagraph("12")
        .AddRow()
            .AddCell().AddParagraph("Джим")
            .AddCell().AddParagraph("27");
// добавить путь к входному файлу
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// установить путь к выходному файлу
opt.AddOutput(new FileDataSource("path_to_the_converted_file.pdf"));
// выполнить процесс
plugin.Process(opt);

Переименован класс PdfDoc в DocConverter

  • Класс DocConverter: Представляет плагин Documentize.DocConverter. Используется для конвертации PDF-документов в формат DOC/DOCX.

Пример использования:

// создать DocConverter
var plugin = new DocConverter();
// создать объект PdfToDocOptions для установки инструкций
var opt = new PdfToDocOptions();
// добавить путь к входному файлу
opt.AddInput(new FileDataSource(inputPath));
// установить путь к выходному файлу
opt.AddOutput(new FileDataSource(outputPath));
// выполнить процесс
plugin.Process(opt);
10 июл. 2025 г.

v24.11

Добавлен новый плагин: Конвертер PDF в JPEG

  • Назначение: Класс JpegConverter предназначен для преобразования документов PDF в формат JPEG, что упрощает пользователям обработку и обмен изображениями, полученными из PDF.
  • Конструктор:
    • JpegConverter(): Инициализирует новый экземпляр конвертера JPEG.

Пример использования:

var plugin = new JpegConverter();
var opt = new PdfToJpegOptions();
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));
plugin.Process(opt);
  • Метод:
    • Process(PdfToJpegOptions options): Запускает процесс конвертации в JPEG с использованием указанных параметров.

Добавлен класс DirectoryDataSource

  • Назначение: Класс DirectoryDataSource позволяет пользователям управлять данными директории для операций загрузки и сохранения в плагинах.
  • Конструктор:
    • DirectoryDataSource(string path): Инициализирует новый объект данных директории с указанным путем.

Пример использования:

var directorySource = new DirectoryDataSource("path_to_your_directory");
  • Свойства:
    • DataType: Получает тип источника данных.
    • Path: Получает путь текущей директории данных.

Добавлен класс PdfToJpegOptions

  • Назначение: Этот класс содержит параметры для настройки процесса конвертации в JPEG, позволяя пользователям указывать разрешение, списки страниц и качество изображения.
  • Конструктор:
    • PdfToJpegOptions(): Инициализирует новый экземпляр параметров для конвертера JPEG.

Свойства:

  • OutputResolution: Указывает разрешение получаемых изображений JPEG.
  • PageList: Список страниц для конвертации из PDF.
  • Quality: Устанавливает качество выходного JPEG.
10 июл. 2025 г.

v24.10

Добавлен новый плагин: PDF/A Конвертер

  • Введена новая функция конвертации PDF/A, позволяющая пользователям легко конвертировать стандартные PDF файлы в документы, соответствующие стандарту PDF/A.

Пример использования:

var options = new PdfAConvertOptions
{
    PdfAVersion = PdfAStandardVersion.PDF_A_3B
};

options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
options.AddOutput(new FileDataSource("path_to_the_converted_file.pdf"));

var plugin = new PdfAConverter();
plugin.Process(options);

Исправления ошибок

  • Исправлены проблемы, связанные с классом FileResult, которые приводили к неправильным выходным путям.
  • Устранены мелкие ошибки, влияющие на HtmlConverter при работе с большими файлами.

Улучшения

  • Повышена производительность PdfExtractor и ImageExtractor для более быстрых времён обработки.
  • Обновлен класс RotateOptions для поддержки дополнительных углов поворота.
10 июл. 2025 г.

v24.9

Выпущено

 Русский