Class Document

Class Document

Namespace: Aspose.Pdf
Assembly: Aspose.PDF.dll

Клас, що представляє PDF документ

public sealed class Document : IDisposable

Спадкування

objectDocument

Реалізує

IDisposable

Спадковані члени

object.GetType(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

Конструктори

Document(Stream)

Ініціалізує новий екземпляр Document з вхідного потоку.

public Document(Stream input)

Параметри

input Stream

Потік з pdf документом.

Document(Stream, string, bool)

Ініціалізує новий екземпляр Document з вхідного потоку.

public Document(Stream input, string password, bool isManagedStream)

Параметри

input Stream

Потік з pdf документом.

password string

Пароль користувача або власника.

isManagedStream bool

якщо встановлено true, внутрішній потік закривається перед виходом; в іншому випадку - ні.

Document(Stream, bool)

Ініціалізує новий екземпляр Document з вхідного потоку.

public Document(Stream input, bool isManagedStream)

Параметри

input Stream

Потік з pdf документом.

isManagedStream bool

якщо встановлено true, внутрішній потік закривається перед виходом; в іншому випадку - ні.

Document(string)

Просто ініціалізує Document, використовуючи filename. Те ж саме, що і Aspose.Pdf.Document.#ctor(System.IO.Stream).

public Document(string filename)

Параметри

filename string

Назва файлу pdf документу.

Document(Stream, string)

Ініціалізує новий екземпляр Document з вхідного потоку.

public Document(Stream input, string password)

Параметри

input Stream

Об’єкт вхідного потоку, відповідний pdf захищений паролем.

password string

Пароль користувача або власника.

Document()

Ініціалізує порожній документ.

public Document()

Document(string, string)

Ініціалізує новий екземпляр класу Aspose.Pdf.Document для роботи з зашифрованим документом.

public Document(string filename, string password)

Параметри

filename string

Назва файлу документу.

password string

Пароль користувача або власника.

Document(string, string, bool)

Ініціалізує новий екземпляр класу Aspose.Pdf.Document для роботи з зашифрованим документом.

public Document(string filename, string password, bool isManagedStream)

Параметри

filename string

Назва файлу документу.

password string

Пароль користувача або власника.

isManagedStream bool

якщо встановлено true, внутрішній потік закривається перед виходом; в іншому випадку - ні.

Document(string, LoadOptions)

Відкриває існуючий документ з файлу, надаючи необхідні параметри конвертації для отримання pdf документу.

public Document(string filename, LoadOptions options)

Параметри

filename string

Вхідний файл для конвертації в pdf документ.

options LoadOptions

Представляє властивості для конвертації filename в pdf документ.

Document(Stream, LoadOptions)

Відкриває існуючий документ з потоку, надаючи необхідні параметри конвертації для отримання pdf документу.

public Document(Stream input, LoadOptions options)

Параметри

input Stream

Вхідний потік для конвертації в pdf документ.

options LoadOptions

Представляє властивості для конвертації input в pdf документ.

Поля

DefaultNodesNumInSubtrees

public const byte DefaultNodesNumInSubtrees = 10

Значення поля

byte

Властивості

Actions

Отримує дії документу. Ця властивість є екземпляром класу DocumentActions, який дозволяє отримувати/встановлювати дії BeforClosing, BeforSaving тощо.

public DocumentActionCollection Actions { get; }

Значення властивості

DocumentActionCollection

Приклади

Цей приклад демонструє, як отримати дію після відкриття документу:

Aspose.Pdf.Document document = new Aspose.Pdf.Document("d:\\work\\aspose\\aspose.pdf.kit.net.new\\trunk\\testdata\\Aspose.Pdf\\PdfWithOpenAction.pdf");
Aspose.Pdf.Annotations.DocumentActionCollection actions = document.Actions;
Aspose.Pdf.Annotations.PdfAction afterSavingAction = actions.AfterSaving;

AllowReusePageContent

Дозволяє об’єднувати вміст сторінок для оптимізації розміру документа. Якщо використовується, то різні, але дублікатні сторінки можуть посилатися на один і той же об’єкт вмісту. Зверніть увагу, що цей режим може викликати побічні ефекти, такі як зміна вмісту сторінки, коли інша сторінка змінюється.

public bool AllowReusePageContent { get; set; }

Значення властивості

bool

Background

Отримує або встановлює колір фону документу.

public Color Background { get; set; }

Значення властивості

Color

CenterWindow

Отримує або встановлює прапорець, що вказує, чи буде вікно документу розташоване по центру екрану.

public bool CenterWindow { get; set; }

Значення властивості

bool

Приклади

Приклад демонструє, як отримати прапорець CenterWindow:

Document document = new Document("sample.pdf");
bool value = document.CenterWindow;

Collection

Отримує колекцію документу.

public Collection Collection { get; set; }

Значення властивості

Collection

CryptoAlgorithm

Отримує налаштування безпеки, якщо документ зашифрований. Якщо документ не зашифрований, то відповідне виключення буде піднято в .net 1.1 або CryptoAlgorithm буде null для інших версій .net.

public CryptoAlgorithm? CryptoAlgorithm { get; }

Значення властивості

CryptoAlgorithm?

Destinations

Отримує колекцію напрямків. Застаріло. Будь ласка, використовуйте NamedDestinations.

public DestinationCollection Destinations { get; }

Значення властивості

DestinationCollection

Direction

Отримує або встановлює порядок читання тексту: L2R (зліва направо) або R2L (праворуч наліво).

public Direction Direction { get; set; }

Значення властивості

Direction

DisableFontLicenseVerifications

Багато операцій з шрифтами не можуть бути виконані, якщо ці операції заборонені ліцензією цього шрифту. Наприклад, деякі шрифти не можуть бути вбудовані в PDF документ, якщо ліцензійні правила забороняють вбудовування для цього шрифту. Цей прапорець використовується для відключення будь-яких ліцензійних обмежень для всіх шрифтів у поточному PDF документі. Будьте обережні, використовуючи цей прапорець. Коли він встановлений, це означає, що особа, яка встановлює цей прапорець, бере на себе всю відповідальність за можливі порушення ліцензій/закону. Отже, він бере це на свій власний ризик. Рекомендується використовувати цей прапорець лише тоді, коли ви повністю впевнені, що не порушуєте авторське право. За замовчуванням false.

public bool DisableFontLicenseVerifications { get; set; }

Значення властивості

bool

DisplayDocTitle

Отримує або встановлює прапорець, що вказує, чи має заголовок вікна документу відображати заголовок документу.

public bool DisplayDocTitle { get; set; }

Значення властивості

bool

Приклади

Приклад демонструє, як отримати прапорець DisplayDocTitle:

Document document = new Document("sample.pdf");
bool value = document.DisplayDocTitle;

Duplex

Отримує або встановлює режим обробки двостороннього друку, який буде використовуватися при друку файлу з діалогу друку.

public PrintDuplex Duplex { get; set; }

Значення властивості

PrintDuplex

EmbedStandardFonts

Властивість, яка оголошує, що документ повинен вбудовувати всі стандартні шрифти Type1, які мають прапорець IsEmbedded, встановлений в true. Усі шрифти PDF можуть бути вбудовані в документ, просто встановивши прапорець IsEmbedded в true, але стандартні шрифти Type1 є винятком з цього правила. Вбудовування стандартних шрифтів Type1 вимагає багато часу, тому для вбудовування цих шрифтів необхідно не лише встановити прапорець IsEmbedded в true для вказаного шрифту, але й встановити додатковий прапорець на рівні документа - EmbedStandardFonts = true; Цю властивість можна встановити лише один раз для всіх шрифтів. За замовчуванням false.

public bool EmbedStandardFonts { get; set; }

Значення властивості

bool

EmbeddedFiles

Отримує колекцію файлів, вбудованих в документ.

public EmbeddedFileCollection EmbeddedFiles { get; }

Значення властивості

EmbeddedFileCollection

EnableObjectUnload

Отримує або встановлює прапорець, який дозволяє частково вивантажити документ з пам’яті. Це дозволяє зменшити використання пам’яті, але може негативно вплинути на продуктивність.

public bool EnableObjectUnload { get; set; }

Значення властивості

bool

EnableSignatureSanitization

Отримує або встановлює прапорець для управління санітарною обробкою полів підпису. Увімкнено за замовчуванням.

public bool EnableSignatureSanitization { get; set; }

Значення властивості

bool

FileName

Назва PDF файлу, який викликав цей документ

public string FileName { get; }

Значення властивості

string

FitWindow

Отримує або встановлює прапорець, що вказує, чи має вікно документу бути змінене в розмірі, щоб відповідати першій відображеній сторінці.

public bool FitWindow { get; set; }

Значення властивості

bool

Приклади

Приклад демонструє, як отримати прапорець FitWindow:

Document document = new Document("sample.pdf");
bool value = document.FitWindow;

FontUtilities

Інстанція IDocumentFontUtilities

public Document.IDocumentFontUtilities FontUtilities { get; }

Значення властивості

Document.IDocumentFontUtilities

Form

Отримує Acro Form документу.

public Form Form { get; }

Значення властивості

Form

HandleSignatureChange

Викидає виключення, якщо документ буде збережено з змінами та має підпис

public bool HandleSignatureChange { get; set; }

Значення властивості

bool

HideMenubar

Отримує або встановлює прапорець, що вказує, чи має меню бути прихованим, коли документ активний.

public bool HideMenubar { get; set; }

Значення властивості

bool

Приклади

Приклад демонструє, як отримати прапорець HideMenubar:

Document document = new Document("sample.pdf");
bool value = document.HideMenubar;

HideToolBar

Отримує або встановлює прапорець, що вказує, чи має панель інструментів бути прихованою, коли документ активний.

public bool HideToolBar { get; set; }

Значення властивості

bool

Приклади

Приклад демонструє, як отримати прапорець HideToolBar:

Document document = new Document("sample.pdf");
bool value = document.HideToolBar;

HideWindowUI

Отримує або встановлює прапорець, що вказує, чи мають елементи інтерфейсу користувача бути прихованими, коли документ активний.

public bool HideWindowUI { get; set; }

Значення властивості

bool

Приклади

Приклад демонструє, як отримати прапорець HideWindowUI:

Document document = new Document("sample.pdf");
bool value = document.HideWindowUI;

Id

Отримує ID.

public Id Id { get; }

Значення властивості

Id

IgnoreCorruptedObjects

Отримує або встановлює прапорець, що ігнорує помилки у вихідних файлах. Коли сторінки з вихідного документу копіюються в цільовий документ, процес копіювання зупиняється з виключенням якщо деякі об’єкти у вихідних файлах пошкоджені, коли цей прапорець є false. приклад: dest.Pages.Add(src.Pages); Якщо цей прапорець встановлено в true, то пошкоджені об’єкти будуть замінені порожніми значеннями. За замовчуванням: true.

public bool IgnoreCorruptedObjects { get; set; }

Значення властивості

bool

Info

Отримує інформацію про документ.

public DocumentInfo Info { get; }

Значення властивості

DocumentInfo

IsEncrypted

Отримує статус шифрування документу. True, якщо документ зашифрований.

public bool IsEncrypted { get; }

Значення властивості

bool

IsLicensed

Отримує ліцензований стан системи. Повертає true, якщо система працює в ліцензованому режимі, і false в іншому випадку.

public static bool IsLicensed { get; }

Значення властивості

bool

IsLinearized

Отримує або встановлює значення, що вказує, чи документ є лініаризованим.

public bool IsLinearized { get; set; }

Значення властивості

bool

IsPdfUaCompliant

Отримує, чи документ відповідає pdfua.

public bool IsPdfUaCompliant { get; }

Значення властивості

bool

IsPdfaCompliant

Отримує, чи документ відповідає pdfa.

public bool IsPdfaCompliant { get; }

Значення властивості

bool

IsXrefGapsAllowed

Отримує або встановлює, чи дозволені прогалини в xref документу.

public bool IsXrefGapsAllowed { get; set; }

Значення властивості

bool

JavaScript

Колекція JavaScript на рівні документу.

public JavaScriptCollection JavaScript { get; }

Значення властивості

JavaScriptCollection

LogicalStructure

Отримує логічну структуру документу.

public RootElement LogicalStructure { get; }

Значення властивості

RootElement

Metadata

Метадані документу. (Документ PDF може містити загальну інформацію, таку як назва документа, автор, дати створення та зміни. Така глобальна інформація про документ (на відміну від його вмісту чи структури) називається метаданими і призначена для допомоги в каталогізації та пошуку документів у зовнішніх базах даних.)

public Metadata Metadata { get; }

Значення властивості

Metadata

NamedDestinations

Колекція іменованих напрямків у документі.

public NamedDestinationCollection NamedDestinations { get; }

Значення властивості

NamedDestinationCollection

NonFullScreenPageMode

Отримує або встановлює режим сторінки, що вказує, як відображати документ після виходу з режиму повного екрану.

public PageMode NonFullScreenPageMode { get; set; }

Значення властивості

PageMode

OpenAction

Отримує або встановлює дію, що виконується при відкритті документу.

public IAppointment OpenAction { get; set; }

Значення властивості

IAppointment

Приклади

Приклад демонструє, як отримати прапорець CenterWindow:

Document document = new Document("sample.pdf");
IAppointment value = document.OpenAction;

OptimizeSize

Отримує або встановлює прапорець оптимізації. Коли сторінки додаються до документу, однакові ресурси в результативному файлі зливаються в один PDF об’єкт, якщо цей прапорець встановлений. Це дозволяє зменшити розмір результативного файлу, але може призвести до повільнішого виконання та більших вимог до пам’яті. Значення за замовчуванням: false.

public bool OptimizeSize { get; set; }

Значення властивості

bool

Outlines

Отримує контури документу.

public OutlineCollection Outlines { get; }

Значення властивості

OutlineCollection

OutputIntents

Отримує колекцію цілей виводу в документі.

public OutputIntents OutputIntents { get; }

Значення властивості

OutputIntents

PageInfo

Отримує або встановлює інформацію про сторінку (тільки для генератора, не заповнюється при читанні документу).

public PageInfo PageInfo { get; set; }

Значення властивості

PageInfo

PageLabels

Отримує мітки сторінок у документі.

public PageLabelCollection PageLabels { get; }

Значення властивості

PageLabelCollection

PageLayout

Отримує або встановлює макет сторінки, який буде використовуватися при відкритті документу.

public PageLayout PageLayout { get; set; }

Значення властивості

PageLayout

PageMode

Отримує або встановлює режим сторінки, що вказує, як документ має бути відображений при відкритті.

public PageMode PageMode { get; set; }

Значення властивості

PageMode

Pages

Отримує або встановлює колекцію сторінок документу. Зверніть увагу, що сторінки нумеруються з 1 у колекції.

public PageCollection Pages { get; }

Значення властивості

PageCollection

Приклади

Приклад нижче демонструє, як працювати з сторінками документу: Як отримати кількість сторінок та як отримати прямокутник початкової сторінки документу.

Aspose.Pdf.Document document = new Aspose.Pdf.Document("sample.pdf");
Aspose.Pdf.PageCollection pages = document.Pages;
System.Console.WriteLine("Документ містить " + pages.Count);
Page page = pages[1];
Rectangle rect = page.Rect;

PdfFormat

Отримує формат PDF

public PdfFormat PdfFormat { get; }

Значення властивості

PdfFormat

Permissions

Отримує дозволи документу.

public int Permissions { get; }

Значення властивості

int

PickTrayByPdfSize

Отримує або встановлює прапорець, що вказує, чи має використовуватися розмір сторінки PDF для вибору вхідного паперового лотка.

public bool PickTrayByPdfSize { get; set; }

Значення властивості

bool

PrintScaling

Отримує або встановлює параметр масштабування сторінки, який буде вибрано, коли діалог друку відображається для цього документу.

public PrintScaling PrintScaling { get; set; }

Значення властивості

PrintScaling

TaggedContent

Отримує доступ до вмісту TaggedPdf.

public ITaggedContent TaggedContent { get; }

Значення властивості

ITaggedContent

Приклади

Цей приклад демонструє, як використовувати тегований вміст для створення нового документу з заголовком, абзацами та зображеннями.

// Створити новий документ
Document document = new Document();

// Отримати тегований вміст
ITaggedContent taggedContent = document.TaggedContent;

// Встановити мову для документу
taggedContent.SetLanguage("en-US");

// Встановити заголовок для PDF документу
taggedContent.SetTitle("Приклад документу");

// Створення та додавання секції
SectElement sect = taggedContent.CreateSectElement();
taggedContent.RootElement.AppendChild(sect);

// Створити заголовок
HeaderElement h1 = taggedContent.CreateHeaderElement(1);
h1.SetText("Заголовок");
sect.AppendChild(h1);

// Створити абзац
ParagraphElement p = taggedContent.CreateParagraphElement();
p.SetTag("Абзац");
p.SetText("Текст абзацу.");
sect.AppendChild(p);

// Створити ілюстрацію
IllustrationElement figure1 = taggedContent.CreateFigureElement();
sect.AppendChild(figure1);
figure1.AlternativeText = "Фігура 1";
figure1.Title = "Зображення 1";
figure1.SetTag("Fig");
figure1.SetImage("path/of/image.jpg");

// Зберегти документ
document.Save("example.pdf");

Version

Отримує версію Pdf з заголовка файлу Pdf.

public string Version { get; }

Значення властивості

string

Методи

BindXml(string)

Прив’язує xml до документу

public void BindXml(string file)

Параметри

file string

XML файл

BindXml(string, string)

Прив’язує xml/xsl до документу

public void BindXml(string xmlFile, string xslFile)

Параметри

xmlFile string

XML файл.

xslFile string

XSL файл, якщо використовується XSLT.

BindXml(Stream, Stream)

Прив’язує xml/xsl до документу

public void BindXml(Stream xmlStream, Stream xslStream)

Параметри

xmlStream Stream

XML потік.

xslStream Stream

XSL потік, якщо використовується XSLT.

BindXml(Stream, Stream, XmlReaderSettings)

Прив’язує xml/xsl до документу

public void BindXml(Stream xmlStream, Stream xslStream, XmlReaderSettings settings)

Параметри

xmlStream Stream

XML потік.

xslStream Stream

XSL потік, якщо використовується XSLT.

settings XmlReaderSettings

Налаштування читача xml.

BindXml(Stream)

Прив’язує xml до документу

public void BindXml(Stream stream)

Параметри

stream Stream

XML потік.

ChangePasswords(string, string, string)

Змінює паролі документу. Цю дію можна виконати лише за допомогою пароля власника.

public void ChangePasswords(string ownerPassword, string newUserPassword, string newOwnerPassword)

Параметри

ownerPassword string

Пароль власника.

newUserPassword string

Новий пароль користувача.

newOwnerPassword string

Новий пароль власника.

Check(bool)

Валідовує документ.

public bool Check(bool doRepair)

Параметри

doRepair bool

Якщо true, знайдені проблеми будуть виправлені.

Повертає

bool

True - якщо документ виправлений; в іншому випадку - false.

Convert(string, PdfFormat, ConvertErrorAction, ConvertTransparencyAction)

Конвертує документ і зберігає помилки у вказаному файлі.

public bool Convert(string outputLogFileName, PdfFormat format, ConvertErrorAction action, ConvertTransparencyAction transparencyAction)

Параметри

outputLogFileName string

Шлях до файлу, де будуть зберігатися коментарі.

format PdfFormat

Формат pdf.

action ConvertErrorAction

Дія для об’єктів, які не можуть бути конвертовані

transparencyAction ConvertTransparencyAction

Дія для об’єктів з маскою зображення

Повертає

bool

Результат операції

Convert(Stream, PdfFormat, ConvertErrorAction, ConvertTransparencyAction)

Конвертує документ і зберігає помилки у вказаному файлі.

public bool Convert(Stream outputLogStream, PdfFormat format, ConvertErrorAction action, ConvertTransparencyAction transparencyAction)

Параметри

outputLogStream Stream

Потік, в якому будуть зберігатися коментарі.

format PdfFormat

Формат pdf.

action ConvertErrorAction

Дія для об’єктів, які не можуть бути конвертовані

transparencyAction ConvertTransparencyAction

Дія для об’єктів з маскою зображення

Повертає

bool

Результат операції

Convert(string, PdfFormat, ConvertErrorAction)

Конвертує документ і зберігає помилки у вказаному файлі.

public bool Convert(string outputLogFileName, PdfFormat format, ConvertErrorAction action)

Параметри

outputLogFileName string

Шлях до файлу, де будуть зберігатися коментарі.

format PdfFormat

Формат pdf.

action ConvertErrorAction

Дія для об’єктів, які не можуть бути конвертовані

Повертає

bool

Результат операції

Convert(PdfFormatConversionOptions)

Конвертує документ, використовуючи вказані параметри конвертації

public bool Convert(PdfFormatConversionOptions options)

Параметри

options PdfFormatConversionOptions

набір параметрів для конвертації PDF документу

Повертає

bool

Результат операції

Convert(CallBackGetHocrWithPage, bool)

Розпізнає зображення всередині документу та додає рядки hocr поверх нього.

public bool Convert(Document.CallBackGetHocrWithPage callback, bool flattenImages = false)

Параметри

callback Document.CallBackGetHocrWithPage

Дія для зображень, які будуть оброблені за допомогою розпізнавання hocr.

flattenImages bool

Текст в зображеннях pdf може бути намальований за допомогою механіки масок, в такому випадку зображення повинні бути сплющені.

Повертає

bool

Результат операції. Якщо в документі немає зображень, повертає false.

Convert(CallBackGetHocr, bool)

Розпізнає зображення всередині документу та додає рядки hocr поверх нього.

public bool Convert(Document.CallBackGetHocr callback, bool flattenImages = false)

Параметри

callback Document.CallBackGetHocr

Дія для зображень, які будуть оброблені за допомогою розпізнавання hocr.

flattenImages bool

Текст в зображеннях pdf може бути намальований за допомогою механіки масок, в такому випадку зображення повинні бути сплющені.

Повертає

bool

Результат операції. Якщо в документі немає зображень, повертає false.

Convert(Stream, PdfFormat, ConvertErrorAction)

Конвертує документ і зберігає помилки у вказаному потоці.

public bool Convert(Stream outputLogStream, PdfFormat format, ConvertErrorAction action)

Параметри

outputLogStream Stream

Потік, в якому будуть зберігатися коментарі.

format PdfFormat

Формат pdf.

action ConvertErrorAction

Дія для об’єктів, які не можуть бути конвертовані

Повертає

bool

Результат операції

Convert(Fixup, Stream, bool, object[])

Конвертує документ, застосовуючи Fixup.

public bool Convert(Fixup fixup, Stream outputLog, bool onlyValidation = false, object[] parameters = null)

Параметри

fixup Fixup

Тип Fixup.

outputLog Stream

Лог процесу.

onlyValidation bool

Тільки валідація документу.

parameters object[]

Властивості для Fixup, які не можуть бути встановлені.

Повертає

bool

Результат операції.

Convert(Fixup, string, bool, object[])

Конвертує документ, застосовуючи Fixup.

public bool Convert(Fixup fixup, string outputLog, bool onlyValidation = false, object[] parameters = null)

Параметри

fixup Fixup

Тип Fixup.

outputLog string

Лог процесу.

onlyValidation bool

Тільки валідація документу.

parameters object[]

Властивості для Fixup, які не можуть бути встановлені.

Повертає

bool

Результат операції.

Convert(string, LoadOptions, string, SaveOptions)

Конвертує вихідний файл у вихідний формат у вихідний файл.

public static void Convert(string srcFileName, LoadOptions loadOptions, string dstFileName, SaveOptions saveOptions)

Параметри

srcFileName string

Назва вихідного файлу.

loadOptions LoadOptions

Формат вихідного файлу.

dstFileName string

Назва вихідного файлу.

saveOptions SaveOptions

Формат вихідного файлу.

Convert(Stream, LoadOptions, string, SaveOptions)

Конвертує потік у вихідний файл у вихідний формат.

public static void Convert(Stream srcStream, LoadOptions loadOptions, string dstFileName, SaveOptions saveOptions)

Параметри

srcStream Stream

Вихідний потік.

loadOptions LoadOptions

Формат вихідного потоку.

dstFileName string

Назва вихідного файлу.

saveOptions SaveOptions

Формат вихідного файлу.

Convert(string, LoadOptions, Stream, SaveOptions)

Конвертує вихідний файл у вихідний формат у потік.

public static void Convert(string srcFileName, LoadOptions loadOptions, Stream dstStream, SaveOptions saveOptions)

Параметри

srcFileName string

Назва вихідного файлу.

loadOptions LoadOptions

Формат вихідного файлу.

dstStream Stream

Вихідний потік.

saveOptions SaveOptions

Формат вихідного потоку.

Convert(Stream, LoadOptions, Stream, SaveOptions)

Конвертує потік у вихідний формат у потік.

public static void Convert(Stream srcStream, LoadOptions loadOptions, Stream dstStream, SaveOptions saveOptions)

Параметри

srcStream Stream

Вихідний потік.

loadOptions LoadOptions

Формат вихідного потоку.

dstStream Stream

Вихідний потік.

saveOptions SaveOptions

Формат вихідного файлу.

ConvertPageToPNGMemoryStream(Page)

Конвертує сторінку в PNG для DSR, OMR, OCR зображення потоку.

public MemoryStream ConvertPageToPNGMemoryStream(Page page)

Параметри

page Page

Сторінка для конвертації.

Повертає

MemoryStream

Потік зображення.

Decrypt()

Розшифровує документ. Викликайте потім Save, щоб отримати розшифрований варіант документу.

public void Decrypt()

Dispose()

Закриває всі ресурси, які використовуються цим документом.

public void Dispose()

Encrypt(string, string, DocumentPrivilege, CryptoAlgorithm, bool)

Шифрує документ. Викликайте потім Save, щоб отримати зашифрований варіант документу.

public void Encrypt(string userPassword, string ownerPassword, DocumentPrivilege privileges, CryptoAlgorithm cryptoAlgorithm, bool usePdf20)

Параметри

userPassword string

Пароль користувача.

ownerPassword string

Пароль власника.

privileges DocumentPrivilege

Дозволи документу, див. Aspose.Pdf.Document.Permissions для деталей.

cryptoAlgorithm CryptoAlgorithm

Криптографічний алгоритм, див. Aspose.Pdf.Document.CryptoAlgorithm для деталей.

usePdf20 bool

Підтримка ревізії 6 (Розширення 8).

Encrypt(string, string, Permissions, CryptoAlgorithm)

Шифрує документ. Викликайте потім Save, щоб отримати зашифрований варіант документу.

public void Encrypt(string userPassword, string ownerPassword, Permissions permissions, CryptoAlgorithm cryptoAlgorithm)

Параметри

userPassword string

Пароль користувача.

ownerPassword string

Пароль власника.

permissions Permissions

Дозволи документу, див. Aspose.Pdf.Document.Permissions для деталей.

cryptoAlgorithm CryptoAlgorithm

Криптографічний алгоритм, див. Aspose.Pdf.Document.CryptoAlgorithm для деталей.

Encrypt(string, string, Permissions, CryptoAlgorithm, bool)

Шифрує документ. Викликайте потім Save, щоб отримати зашифрований варіант документу.

public void Encrypt(string userPassword, string ownerPassword, Permissions permissions, CryptoAlgorithm cryptoAlgorithm, bool usePdf20)

Параметри

userPassword string

Пароль користувача.

ownerPassword string

Пароль власника.

permissions Permissions

Дозволи документу, див. Aspose.Pdf.Document.Permissions для деталей.

cryptoAlgorithm CryptoAlgorithm

Криптографічний алгоритм, див. Aspose.Pdf.Document.CryptoAlgorithm для деталей.

usePdf20 bool

Підтримка ревізії 6 (Розширення 8).

ExportAnnotationsToXfdf(string)

Експортує всі анотації документу в файл XFDF

public void ExportAnnotationsToXfdf(string fileName)

Параметри

fileName string

Назва файлу XFDF

ExportAnnotationsToXfdf(Stream)

Експортує всі анотації документу в потік.

public void ExportAnnotationsToXfdf(Stream stream)

Параметри

stream Stream

Потік, в якому буде зберігатися XFDF.

Flatten()

Видаляє всі поля з документу та замінює їх значеннями.

public void Flatten()

Flatten(FlattenSettings)

Видаляє всі поля (та анотації) з документу та замінює їх значеннями.

public void Flatten(Form.FlattenSettings flattenSettings)

Параметри

flattenSettings Form.FlattenSettings

Налаштування для процесу сплющення.

FlattenTransparency()

Замінює прозорий вміст на непрозору растрову та векторну графіку.

public void FlattenTransparency()

FreeMemory()

Очищає пам’ять

public void FreeMemory()

GetCatalogValue(string)

Повертає значення елемента з каталогу.

public object GetCatalogValue(string key)

Параметри

key string

Ключ елемента.

Повертає

object

Значення елемента - якщо ключ було успішно знайдено; в іншому випадку - null.

GetObjectById(string)

Отримує об’єкт з вказаним ID у документі.

public object GetObjectById(string id)

Параметри

id string

ID об’єкта.

Повертає

object

Об’єкт з вказаним id. Null, якщо id не знайдено.

GetXmpMetadata(Stream)

Отримує XMP метадані з документу.

public void GetXmpMetadata(Stream stream)

Параметри

stream Stream

Потік, в якому будуть зберігатися метадані.

HasIncrementalUpdate()

Перевіряє, чи був поточний PDF документ збережений з інкрементальними оновленнями.

public bool HasIncrementalUpdate()

Повертає

bool

true, якщо PDF документ має інкрементальні оновлення; в іншому випадку - false.

ImportAnnotationsFromXfdf(string)

Імпортує анотації з файлу XFDF до документу.

public void ImportAnnotationsFromXfdf(string fileName)

Параметри

fileName string

Назва файлу XFDF

ImportAnnotationsFromXfdf(Stream)

Імпортує анотації з потоку до документу.

public void ImportAnnotationsFromXfdf(Stream stream)

Параметри

stream Stream

Потік, що містить дані XFDF.

LoadFrom(string, LoadOptions)

Завантажує файл, конвертуючи його в PDF.

public void LoadFrom(string filename, LoadOptions options)

Параметри

filename string

Шлях до файлу для відкриття.

options LoadOptions

Параметри завантаження.

Виключення

PdfException

Якщо файл не може бути завантажений.

FileNotFoundException

Якщо файл не знайдено.

Merge(MergeOptions, params Document[])

Об’єднує документи.

public void Merge(Document.MergeOptions mergeOptions, params Document[] documents)

Параметри

mergeOptions Document.MergeOptions

Параметри об’єднання.

documents Document[]

Документи для об’єднання.

Merge(MergeOptions, params string[])

Об’єднує документи.

public void Merge(Document.MergeOptions mergeOptions, params string[] files)

Параметри

mergeOptions Document.MergeOptions

Параметри об’єднання.

files string[]

PDF-файли для об’єднання.

Merge(params Document[])

Об’єднує документи.

public void Merge(params Document[] documents)

Параметри

documents Document[]

Документи для об’єднання.

Merge(params string[])

Об’єднує PDF файли.

public void Merge(params string[] files)

Параметри

files string[]

PDF-файли для об’єднання.

MergeDocuments(MergeOptions, params string[])

Об’єднує документи.

public static Document MergeDocuments(Document.MergeOptions mergeOptions, params string[] files)

Параметри

mergeOptions Document.MergeOptions

Параметри об’єднання.

files string[]

PDF-файли для об’єднання.

Повертає

Document

Об’єднаний документ.

MergeDocuments(MergeOptions, params Document[])

Об’єднує документи.

public static Document MergeDocuments(Document.MergeOptions mergeOptions, params Document[] files)

Параметри

mergeOptions Document.MergeOptions

files Document[]

Документи для об’єднання.

Повертає

Document

Об’єднаний документ.

MergeDocuments(params string[])

Об’єднує PDF файли.

public static Document MergeDocuments(params string[] files)

Параметри

files string[]

PDF-файли для об’єднання.

Повертає

Document

Об’єднаний документ.

MergeDocuments(params Document[])

Об’єднує документи.

public static Document MergeDocuments(params Document[] documents)

Параметри

documents Document[]

Документи для об’єднання.

Повертає

Document

Об’єднаний документ.

Optimize()

Лініаризує документ, щоб

  • швидко відкрити першу сторінку;
  • швидко відобразити наступну сторінку або перейти за посиланням на наступну сторінку;
  • відображати сторінку по мірі її надходження, коли дані для сторінки доставляються через повільний канал (відображати найбільш корисні дані спочатку);
  • дозволити взаємодію користувача, таку як перехід за посиланням, виконуватися навіть до того, як вся сторінка була отримана та відображена. Виклик цього методу фактично не зберігає документ. Навпаки, документ лише готується до наявності оптимізованої структури, викликайте потім Save, щоб отримати оптимізований документ.
public void Optimize()

OptimizeResources()

Оптимізує ресурси в документі:

  1. Ресурси, які не використовуються на сторінках документу, видаляються;
  2. Однакові ресурси об’єднуються в один об’єкт;
  3. Невикористовувані об’єкти видаляються.
public void OptimizeResources()

OptimizeResources(OptimizationOptions)

Оптимізує ресурси в документі відповідно до визначеної стратегії оптимізації.

public void OptimizeResources(OptimizationOptions strategy)

Параметри

strategy OptimizationOptions

Стратегія оптимізації.

PageNodesToBalancedTree(byte)

Організовує вузли дерева сторінок у документі в збалансоване дерево. Лише якщо документ має більше ніж nodesNumInSubtrees об’єктів сторінок, інакше не робить нічого. Не викликайте цей метод під час ітерації по елементах Pages, це може дати непередбачувані результати.

public void PageNodesToBalancedTree(byte nodesNumInSubtrees = 10)

Параметри

nodesNumInSubtrees byte

Бажана кількість підвузлів. Значення за замовчуванням - десять.

ProcessParagraphs()

Обробляє абзаци для генератора.

public void ProcessParagraphs()

RemoveMetadata()

Видаляє метадані з документу.

public void RemoveMetadata()

RemovePdfUaCompliance()

Видаляє відповідність pdfUa з документу.

public void RemovePdfUaCompliance()

RemovePdfaCompliance()

Видаляє відповідність pdfa з документу.

public void RemovePdfaCompliance()

Repair()

Виправляє пошкоджений документ.

public void Repair()

Save(Stream)

Зберігає документ у потік.

public void Save(Stream output)

Параметри

output Stream

Потік, в якому документ має бути збережений.

Save(string)

Зберігає документ у вказаному файлі.

public void Save(string outputFileName)

Параметри

outputFileName string

Шлях до файлу, в якому буде збережений документ.

Save()

Зберігає документ інкрементально (тобто, використовуючи техніку інкрементального оновлення).

public void Save()

Зауваження

Щоб зберегти документ інкрементально, ми повинні відкрити файл документу для запису. Тому Document повинен бути ініціалізований з записуваним потоком, як у наступному фрагменті коду: Document doc = new Document(new FileStream(“document.pdf”, FileMode.Open, FileAccess.ReadWrite)); // внести деякі зміни та зберегти документ інкрементально doc.Save();

Save(SaveOptions)

Зберігає документ з параметрами збереження.

public void Save(SaveOptions options)

Параметри

options SaveOptions

Параметри збереження.

Save(string, SaveFormat)

Зберігає документ з новим ім’ям разом з форматом файлу.

public void Save(string outputFileName, SaveFormat format)

Параметри

outputFileName string

Шлях до файлу, в якому буде збережений документ.

format SaveFormat

Параметри формату.

Save(Stream, SaveFormat)

Зберігає документ з новим ім’ям разом з форматом файлу.

public void Save(Stream outputStream, SaveFormat format)

Параметри

outputStream Stream

Потік, в якому буде збережений документ.

format SaveFormat

Параметри формату.

Виключення

ArgumentException

System.ArgumentException, коли Aspose.Pdf.HtmlSaveOptions передається методу. Збереження документа в html потік не підтримується. Будь ласка, використовуйте метод збереження у файл.

Save(string, SaveOptions)

Зберігає документ з новим ім’ям, встановлюючи його параметри збереження.

public void Save(string outputFileName, SaveOptions options)

Параметри

outputFileName string

Шлях до файлу, в якому буде збережений документ.

options SaveOptions

Параметри збереження.

Save(Stream, SaveOptions)

Зберігає документ у потік з параметрами збереження.

public void Save(Stream outputStream, SaveOptions options)

Параметри

outputStream Stream

Потік, в якому буде збережений документ.

options SaveOptions

Параметри збереження.

Виключення

ArgumentException

System.ArgumentException, коли Aspose.Pdf.HtmlSaveOptions передається методу. Збереження документа в html потік не підтримується. Будь ласка, використовуйте метод збереження у файл.

SaveAsync(Stream, CancellationToken)

Зберігає документ у потік.

public Task SaveAsync(Stream output, CancellationToken cancellationToken)

Параметри

output Stream

Потік, в якому документ має бути збережений.

cancellationToken CancellationToken

Токен скасування.

Повертає

Task

Асинхронне завдання.

SaveAsync(string, CancellationToken)

Зберігає документ у вказаному файлі.

public Task SaveAsync(string outputFileName, CancellationToken cancellationToken)

Параметри

outputFileName string

Шлях до файлу, в якому буде збережений документ.

cancellationToken CancellationToken

Токен скасування.

Повертає

Task

Асинхронне завдання.

SaveAsync(CancellationToken)

Зберігає документ інкрементально (тобто, використовуючи техніку інкрементального оновлення).

public Task SaveAsync(CancellationToken cancellationToken)

Параметри

`

 Українська