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 из input потока.

public Document(Stream input)

Параметры

input Stream

Поток с PDF-документом.

Document(Stream, string, bool)

Инициализация нового экземпляра Document из input потока.

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

Параметры

input Stream

Поток с PDF-документом.

password string

Пароль пользователя или владельца.

isManagedStream bool

Если установлено в true, внутренний поток закрывается перед выходом; в противном случае — нет.

Document(Stream, bool)

Инициализация нового экземпляра Document из input потока.

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 из input потока.

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 PDF являются исключением из этого правила. Встраивание стандартного шрифта 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("Document contains " + 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("Example document");

// Создание и добавление секции
SectElement sect = taggedContent.CreateSectElement();
taggedContent.RootElement.AppendChild(sect);

// Создать заголовок
HeaderElement h1 = taggedContent.CreateHeaderElement(1);
h1.SetText("The Header");
sect.AppendChild(h1);

// Создать абзац
ParagraphElement p = taggedContent.CreateParagraphElement();
p.SetTag("Paragraph");
p.SetText("The text of paragraph.");
sect.AppendChild(p);

// Создать иллюстрацию
IllustrationElement figure1 = taggedContent.CreateFigureElement();
sect.AppendChild(figure1);
figure1.AlternativeText = "Figure 1";
figure1.Title = "Image 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)

Параметры

cancellationToken CancellationToken

Токен отмены.

Возвращает

Task

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

Примечания

Для того чтобы сохранить документ инкрементально, мы должны открыть файл документа для записи. Поэтому Document должен быть инициализирован с помощью записываемого потока, как в следующем фрагменте кода: Document doc = new Document(new FileStream(“document.pdf”, FileMode.Open, FileAccess.ReadWrite)); // внесите некоторые изменения и сохраните документ инкрементально doc.Save();

SaveAsync(SaveOptions, CancellationToken)

Сохраняет документ с параметрами сохранения.

public Task SaveAsync(SaveOptions options, CancellationToken cancellationToken)

Параметры

options SaveOptions

Параметры сохранения.

cancellationToken CancellationToken

Токен отмены.

Возвращает

Task

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

SaveAsync(string, SaveFormat, CancellationToken)

Сохраняет документ с новым именем вместе с форматом файла.

public Task SaveAsync(string outputFileName, SaveFormat format, CancellationToken cancellationToken)

Параметры

outputFileName string

Путь к файлу, в котором документ будет сохранен.

format SaveFormat

Параметры формата.

cancellationToken CancellationToken

Токен отмены.

Возвращает

Task

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

SaveAsync(Stream, SaveFormat, CancellationToken)

Сохраняет документ с новым именем вместе с форматом файла.

public Task SaveAsync(Stream outputStream, SaveFormat format, CancellationToken cancellationToken)

Параметры

outputStream Stream

Поток, в котором документ будет сохранен.

format SaveFormat

Параметры формата.

cancellationToken CancellationToken

Токен отмены.

Возвращает

Task

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

Исключения

ArgumentException

System.ArgumentException, когда Aspose.Pdf.HtmlSaveOptions передан методу. Сохранение документа в HTML-поток не поддерживается. Пожалуйста, используйте метод сохранения в файл.

SaveAsync(string, SaveOptions, CancellationToken)

Сохраняет документ с новым именем, устанавливая его параметры сохранения.

public Task SaveAsync(string outputFileName, SaveOptions options, CancellationToken cancellationToken)

Параметры

outputFileName string

Путь к файлу, в котором документ будет сохранен.

options SaveOptions

Параметры сохранения.

cancellationToken CancellationToken

Токен отмены.

Возвращает

Task

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

SaveAsync(Stream, SaveOptions, CancellationToken)

Сохраняет документ в поток с параметрами сохранения.

public Task SaveAsync(Stream outputStream, SaveOptions options, CancellationToken cancellationToken)

Параметры

outputStream Stream

Поток, в котором документ будет сохранен.

options SaveOptions

Параметры сохранения.

cancellationToken CancellationToken

Токен отмены.

Возвращает

Task

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

Исключения

ArgumentException

System.ArgumentException, когда Aspose.Pdf.HtmlSaveOptions передан методу. Сохранение документа в HTML-поток не поддерживается. Пожалуйста, используйте метод сохранения в файл.

SaveXml(string)

Сохраняет документ в XML.

public void SaveXml(string file)

Параметры

file [string](https://learn.microsoft

 Русский