1. Продукти
  2.   Aspose.PDF
  3.   Aspose.PDF FOSS for .NET

Aspose.PDF FOSS for .NET

Створюйте та маніпулюйте PDF‑документами за допомогою .NET — з анотаціями, полями форм, витягом тексту, керуванням сторінками, шифруванням та імпортом HTML/SVG/Markdown. Під ліцензією MIT.

Aspose.PDF FOSS for .NET Aspose.PDF FOSS
for .NET

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

Безкоштовна бібліотека .NET під ліцензією MIT для створення та маніпулювання PDF

Aspose.PDF FOSS for .NET — це бібліотека з ліцензією MIT для створення та роботи з PDF‑документами у C# та .NET. Центральною точкою входу є клас Document, який підтримує створення з шляху до файлу, масиву байтів, потоку або захищених паролем джерел, і надає операції Open, Save, Merge, Encrypt, Decrypt та Convert у всій специфікації PDF.

Бібліотека надає 805 класів, що охоплюють структуру документа через Document, Page та PageCollection; багаті анотації через AnnotationCollection (включаючи AddTextAnnotation, AddLinkAnnotation, AddHighlightAnnotation, AddWatermarkAnnotation та AddRedactAnnotation); інтерактивні форми з Form, ButtonField, CheckboxField, RadioButtonField та ChoiceField; вилучення тексту та пошук за допомогою TextFragmentAbsorber і TextFragment; виявлення таблиць за допомогою AbsorbedTable, AbsorbedRow та AbsorbedCell; та безпека документів через Document.Encrypt і Document.Decrypt. Конвертація форматів підтримує HTML, SVG та імпорт Markdown разом з експортом PDF.

Встановіть Aspose.PDF FOSS для .NET з NuGet: dotnet add package Aspose.Pdf.Foss --version 0.1.0-alpha. Бібліотека повністю ліцензована під MIT без плат за виконання чи обмежень використання. Для корпоративних функцій та підтримки дивіться Aspose.PDF for .NET — Enterprise Product.

Структура документа та керування сторінками

  • Document API: Створюйте нові PDF‑файли за допомогою Document() або відкривайте існуючі файли через Document.Open(path), Document.Open(data) або Document.Open(stream).
  • Управління сторінками: Додайте, отримуйте доступ і змінюйте порядок сторінок за допомогою PageCollection. Кожен Page надає Width, Height, MediaBox, обертання та Annotations.
  • Об’єднання та розділення: Об’єднуйте кілька файлів за допомогою Document.Merge(documents) або Document.MergeDocuments(files). Імпортуйте конкретні сторінки за допомогою Document.ImportPage та Document.ImportPages.
  • Метадані: Читати та записувати метадані документа за допомогою DocumentInfo та Document.GetOrCreateMetadata().
  • Серіалізація: Зберігайте документи за допомогою Document.Save(filename), Document.Save(stream, format) або Document.ToArray().

Загальні сценарії обробки документів

  • PDF generation: Створюйте документи програмно, створюючи екземпляр Document та заповнюючи сторінки вмістом.
  • Аналіз документа: Відкрийте існуючі файли для перевірки метаданих, вимірювання розмірів сторінки або перелічення полів форми.
  • Маніпуляція сторінками: Змінюйте розмір, обертайте або змінюйте порядок сторінок, використовуючи Document.ImportPage та API Page.
  • Пакетне об’єднання: Зберіть розділи звіту або сторінки рахунку в один PDF, використовуючи Document.MergeDocuments.

Анотації та поля форм

  • Rich annotation API: AnnotationCollection надає методи для анотацій text, link, highlight, underline, strikeout, square, circle, line, ink, stamp, caret, redact, watermark, polygon та polyline.
  • Дії посилань: Додайте URI‑посилання за допомогою AddLinkAnnotation(rect, uri) або внутрішні посилання на стрибки сторінки за допомогою AddLinkAnnotation(rect, destinationPage, destRect).
  • Інтерактивні форми: Доступ до форми документа через Document.Form, щоб перерахувати або створити ButtonField, CheckboxField, RadioButtonField та ChoiceField екземпляри.
  • Вибір анотацій: Фільтруйте анотації за типом по всіх сторінках, використовуючи AnnotationSelector з перевантаженнями Visit для кожного типу.
  • Прапори анотації: Керуйте видимістю, друком та поведінкою блокування за допомогою AnnotationFlags.

Сценарії перегляду документів і спільної роботи

  • Огляд розмітки: Додайте підсвічування, підкреслення або вільнотекстові анотації для процесів перегляду документів.
  • Редагування: Постійно видаляти ділянки конфіденційного вмісту за допомогою AddRedactAnnotation.
  • Водяний знак: Нанесіть текст CONFIDENTIAL або APPROVED на сторінки за допомогою AddWatermarkAnnotation та AddStampAnnotation.
  • Інтерактивні форми: Створюйте заповнювані документи з радіокнопками, прапорцями та списками вибору для конвеєрів захоплення даних.

Витяг тексту та пошук

  • Пошук тексту: Використовуйте TextFragmentAbsorber, щоб знайти всі фрагменти тексту на сторінці або в усьому документі, з необов’язковим збігом фраз.
  • Властивості фрагмента: Кожен TextFragment надає Text, Position, TextState (шрифт, розмір, колір), і обмежувальний прямокутник.
  • Керування станом тексту: TextFragmentState надає доступ до Font, FontSize, ForegroundColor, BackgroundColor, і режиму рендерингу.
  • Виявлення таблиць: Визначайте та витягайте табличний вміст за допомогою AbsorbedTable, AbsorbedRow та AbsorbedCell, кожен з яких надає Rect і TextFragments.

Сценарії витягування тексту та даних

  • Індексація вмісту: Витягнути весь текст сторінки для конвеєрів повнотекстового пошуку.
  • Витяг даних форми: Читати надіслані значення полів для обробки на боці сервера.
  • Обробка рахунків: Використовуйте AbsorbedTable для розбору табличних даних у вигляді рядків і стовпців з фінансових PDF.
  • Порівняння редлайну: Знаходьте конкретні фрагменти тексту для точного позиційного анотування або заміни.

Безпека та шифрування

  • AES and RC4 encryption: Шифруйте документи за допомогою Document.Encrypt(userPassword, ownerPassword, permissions, algorithm), використовуючи Algorithm.AESx128, AESx256 або RC4x128.
  • Контроль доступу: Обмежте друк, копіювання та доступність за допомогою DocumentPrivilege.
  • Керування паролями: Змініть паролі користувача та власника за допомогою Document.ChangePasswords.
  • Розшифрування: Видалити захист за допомогою Document.Decrypt().
  • Цифрові підписи: Доступ до полів підпису та даних PKCS#7 через типи Signature та Algorithm.

Сценарії безпеки документів

  • Конфіденційний розподіл: Шифруйте PDF-файли за допомогою паролів для кожного отримувача перед доставкою.
  • Контракти лише для друку: Застосуйте паролі власника з режимом лише друк DocumentPrivilege, щоб запобігти копіюванню.
  • Архівування відповідності: Видалити шифрування з внутрішніх архівів після перевірки безпеки.
  • Перевірка підпису: Перевірте вбудовані цифрові підписи у отриманих PDF‑файлах для перевірки їх автентичності.

Відкрити PDF, додати анотацію‑посилання та зберегти

Відкрийте існуючий PDF, додайте анотацію посилання URI на сторінку 1 і збережіть результат.

using Aspose.Pdf;

var data = System.IO.File.ReadAllBytes("input.pdf");
using var doc = Document.Open(data);
var page = doc.Pages[1];
var action = PdfAction.CreateUri("https://aspose.com");
page.Annotations.AddLinkAnnotation(
    new Rectangle(50, 700, 200, 720), action);
using var ms = new System.IO.MemoryStream();
doc.Save(ms);
System.IO.File.WriteAllBytes("output.pdf", ms.ToArray());

Додати анотацію водяного знака

Накладіть водяний знак на сторінку 1 існуючого документа та здійсніть круговий прохід через серіалізацію.

using Aspose.Pdf;
var input = System.IO.File.ReadAllBytes("report.pdf");
using var doc = Document.Open(input);
doc.Pages[1].Annotations.AddWatermarkAnnotation(
    new Rectangle(0, 0, 612, 792), "CONFIDENTIAL");
var saved = doc.ToArray();
System.IO.File.WriteAllBytes("watermarked.pdf", saved);

Витягнути фрагменти тексту зі сторінки

Використовуйте TextFragmentAbsorber, щоб нумерувати всі текстові фрагменти на першій сторінці.

using Aspose.Pdf;
using Aspose.Pdf.Text;

var data = System.IO.File.ReadAllBytes("document.pdf");
using var doc = Document.Open(data);
var absorber = new TextFragmentAbsorber();
absorber.Visit(doc.Pages[1]);
foreach (var fragment in absorber.TextFragments)
{
    Console.WriteLine(fragment.Text);
}

Часті Питання

Яка модель ліцензування для Aspose.PDF FOSS для .NET?

Aspose.PDF FOSS для .NET випущено під ліцензією MIT, що дозволяє вільне використання у комерційних продуктах без річних платежів. Вихідний код доступний публічно на GitHub.

Як встановити Aspose.PDF FOSS для .NET?

Встановіть з NuGet за допомогою dotnet add package Aspose.Pdf.Foss --version 0.1.0-alpha. Бібліотека орієнтована на .NET 8 і новіші версії без нативних залежностей.

Які формати файлів підтримує Aspose.PDF FOSS для .NET?

Бібліотека читає та записує PDF і підтримує імпорт HTML, SVG та Markdown. Доступний також растровий експорт — сторінки PDF можна рендерити у BMP, JPEG, PNG та TIFF.

Як створити новий PDF документ?

Використайте Document.Create() для створення порожнього документа, потім додайте сторінки та збережіть за допомогою Document.Save(stream) або Document.ToArray().

Чи потрібен ліцензійний ключ для використання Aspose.PDF FOSS для .NET?

Ключ ліцензії або крок активації не потрібні. Бібліотека працює повністю без ліцензії безкоштовно під ліцензією MIT.

  

Ресурси Підтримки та Навчання

 Українська