Class PdfFileEditor

Класс PdfFileEditor

Реализует операции с PDF файлом: конкатенация, разделение, извлечение страниц, создание буклетов и т.д.

public sealed class PdfFileEditor

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

ИмяОписание
PdfFileEditor()Конструктор по умолчанию.

Свойства

ИмяОписание
CloseConcatenatedStreams { get; set; }Если установлено в true, потоки закрываются после операции.
ConcatenationPacketSize { get; set; }Количество документов, конкатенированных перед новым инкрементным обновлением во время конкатенации, когда UseDiskBuffer установлено в true.
ConversionLog { get; }Получает журнал процесса конвертации.
ConvertTo { set; }Устанавливает формат PDF файла. Результирующий файл будет сохранен в указанном формате файла. Если это свойство не указано, файл будет сохранен в формате PDF по умолчанию без конвертации.
CopyLogicalStructure { get; set; }Если true, то логическая структура файла копируется при выполнении конкатенации.
CopyOutlines { get; set; }Если true, то контуры будут скопированы.
CorruptedFileAction { get; set; }Это свойство определяет поведение, когда процесс конкатенации встретил поврежденный файл. Возможные значения: StopWithError и ConcatenateIgnoringCorrupted.
CorruptedItems { get; }Массив обнаруженных проблем при выполнении конкатенации. Для каждого поврежденного документа из переданного в функцию Concatenate() создается новая запись CorruptedItem. Это свойство может использоваться только тогда, когда CorruptedFileAction равно ConcatenateIgnoringCorrupted.
IncrementalUpdates { get; set; }Если true, инкрементные обновления выполняются во время конкатенации.
KeepActions { get; set; }Если true, действия будут скопированы из исходных документов. Значение по умолчанию: true.
KeepFieldsUnique { get; set; }Если true, имена полей будут уникальными при конкатенации форм. Суффиксы будут добавлены к именам полей, шаблон суффикса может быть указан в свойстве UniqueSuffix.
LastException { get; }Получает последнее возникшее исключение. Может использоваться для проверки причины сбоя.
MergeDuplicateLayers { get; set; }Дополнительное содержимое конкатенированных документов с одинаковыми именами будет объединено в один слой в результирующем документе, если это свойство равно true. В противном случае слои с одинаковыми именами будут сохранены как разные слои в результирующем документе.
MergeDuplicateOutlines { get; set; }Если true, дублирующиеся контуры объединяются.
OptimizeSize { get; set; }Получает или устанавливает флаг оптимизации. Равные ресурсные потоки в результирующем файле объединяются в один объект PDF, если этот флаг установлен. Это позволяет уменьшить размер результирующего файла, но может привести к более медленному выполнению и большим требованиям к памяти. Значение по умолчанию: false.
OwnerPassword { get; set; }Устанавливает пароль владельца, если исходный входной PDF файл зашифрован. Это свойство еще не реализовано.
PreserveUserRights { get; set; }Если true, права пользователя первого документа применяются к конкатенированному документу. Права пользователя всех других документов игнорируются.
RemoveSignatures { get; set; }Если true, все подписи будут удалены из полей (поля останутся); в противном случае вы можете получить недействительные подписи.
UniqueSuffix { get; set; }Формат суффикса, который добавляется к имени поля, чтобы сделать его уникальным при конкатенации форм. Эта строка должна содержать подстроку %NUM%, которая будет заменена на числа. Например, если UniqueSuffix = “ABC%NUM%”, то для поля “fieldName” имена будут: fieldNameABC1, fieldNameABC2, fieldNameABC3 и т.д.
UseDiskBuffer { get; set; }Если эта опция используется, то целевой документ будет периодически сохраняться на диске, и дальнейшая конкатенация будет применяться к нему как инкрементные обновления.

Методы

ИмяОписание
AddMargins(Stream, Stream, int[], double, double, double, double)Изменяет размер содержимого страницы и добавляет указанные поля. Поля указаны в единицах измерения по умолчанию.
AddMargins(string, string, int[], double, double, double, double)Изменяет размер содержимого страницы и добавляет указанные поля. Поля указаны в единицах измерения по умолчанию.
AddMarginsPct(Stream, Stream, int[], double, double, double, double)Изменяет размер содержимого страницы и добавляет указанные поля. Поля указаны в процентах от начального размера страницы.
AddMarginsPct(string, string, int[], double, double, double, double)Изменяет размер содержимого страницы и добавляет указанные поля. Поля указаны в процентах от начального размера страницы.
AddPageBreak(Document, Document, PageBreak[])Добавляет разрывы страниц в страницы документа.
AddPageBreak(Stream, Stream, PageBreak[])Добавляет разрывы страниц в страницы документа.
AddPageBreak(string, string, PageBreak[])Добавляет разрывы страниц в страницы документа.
Append(Stream, Stream, int, int, Stream)Добавляет страницы, выбранные из portStream в диапазоне от startPage до endPage, в portStream в конце firstInputStream.
Append(Stream, Stream[], int, int, Stream)Добавляет страницы, выбранные из массива документов в portStreams. Результирующий документ включает firstInputFile и все страницы документов portStreams в диапазоне startPage до endPage.
Append(string, string, int, int, string)Добавляет страницы, выбранные из portFile в диапазоне от startPage до endPage, в portFile в конце firstInputFile.
Append(string, string[], int, int, string)Добавляет страницы, выбранные из документов portFiles. Результирующий документ включает firstInputFile и все страницы документов portFiles в диапазоне startPage до endPage.
Concatenate(Document[], Document)Конкатенирует документы.
Concatenate(Stream[], Stream)Конкатенирует файлы.
Concatenate(string[], string)Конкатенирует файлы в один файл.
Concatenate(Stream, Stream, Stream)Конкатенирует два файла.
Concatenate(string, string, string)Конкатенирует два файла.
Concatenate(Stream, Stream, Stream, Stream)Объединяет два PDF документа в новый PDF документ с чередующимися страницами и заполняет пустые места пустыми страницами. Например: document1 имеет 5 страниц: p1, p2, p3, p4, p5. document2 имеет 3 страницы: p1’, p2’, p3’. Объединение двух PDF документов приведет к результату с страницами: p1, p1’, p2, p2’, p3, p3’, p4, blankpage, p5, blankpage.
Concatenate(string, string, string, string)Объединяет два PDF документа в новый PDF документ с чередующимися страницами и заполняет пустые места пустыми страницами. Например: document1 имеет 5 страниц: p1, p2, p3, p4, p5. document2 имеет 3 страницы: p1’, p2’, p3’. Объединение двух PDF документов приведет к результату с страницами: p1, p1’, p2, p2’, p3, p3’, p4, blankpage, p5, blankpage.
Delete(Stream, int[], Stream)Удаляет страницы, указанные массивом номеров, из входного файла, сохраняет как новый PDF файл.
Delete(string, int[], string)Удаляет страницы, указанные массивом номеров, из входного файла, сохраняет как новый PDF файл.
Extract(Stream, int[], Stream)Извлекает страницы, указанные массивом номеров, сохраняет как новый PDF файл.
Extract(string, int[], string)Извлекает страницы, указанные массивом номеров, сохраняет как новый PDF файл.
Extract(Stream, int, int, Stream)Извлекает страницы из входного файла, сохраняет как новый PDF файл.
Extract(string, int, int, string)Извлекает страницы из входного файла, сохраняет как новый PDF файл.
Insert(Stream, int, Stream, int[], Stream)Вставляет страницы из другого файла в входной PDF файл.
Insert(string, int, string, int[], string)Вставляет страницы из другого файла в входной PDF файл.
Insert(Stream, int, Stream, int, int, Stream)Вставляет страницы из другого файла в входной PDF файл.
Insert(string, int, string, int, int, string)Вставляет страницы из другого файла в PDF файл в указанной позиции.
MakeBooklet(Stream, Stream)Создает буклет из InputStream в outputStream.
MakeBooklet(string, string)Создает буклет из входного файла в выходной файл.
MakeBooklet(Stream, Stream, PageSize)Создает буклет из входного потока и сохраняет результат в выходной поток.
MakeBooklet(string, string, PageSize)Создает буклет из inputFile в outputFile.
MakeBooklet(Stream, Stream, int[], int[])Создает индивидуальный буклет из firstInputStream в outputStream.
MakeBooklet(string, string, int[], int[])Создает индивидуальный буклет из firstInputFile в outputFile.
MakeBooklet(Stream, Stream, PageSize, int[], int[])Создает буклет из firstInputStream в outputStream.
MakeBooklet(string, string, PageSize, int[], int[])Создает индивидуальный буклет из firstInputFile в outputFile.
MakeNUp(Stream, Stream, Stream)Создает документ N-Up из двух входных PDF потоков в outputStream.
MakeNUp(Stream[], Stream, bool)Создает документ N-Up из нескольких входных PDF потоков в outputStream. Каждая страница outputStream будет содержать несколько страниц, которые являются комбинацией страниц во входных потоках с одинаковым номером страницы. Многостраничные документы укладываются горизонтально, если isSidewise равно true, и вертикально, если isSidewise равно false.
MakeNUp(string, string, string)Создает документ N-Up из двух входных PDF файлов в outputFile. Каждая страница outputFile будет содержать две страницы, одна страница из первого входного файла и другая из второго входного файла. Две страницы укладываются горизонтально.
MakeNUp(string[], string, bool)Создает документ N-Up из нескольких входных PDF файлов в outputFile. Каждая страница outputFile будет содержать несколько страниц, которые являются комбинацией страниц во входных файлах с одинаковым номером страницы. Многостраничные документы укладываются горизонтально, если isSidewise равно true, и вертикально, если isSidewise равно false.
MakeNUp(Stream, Stream, int, int)Создает документ N-Up из входного потока и сохраняет результат в выходной поток.
MakeNUp(string, string, int, int)Создает документ N-Up из firstInputFile в outputFile.
MakeNUp(Stream, Stream, int, int, PageSize)Создает документ N-Up из первого входного потока в выходной поток.
MakeNUp(string, string, int, int, PageSize)Создает документ N-Up из входного файла в outputFile.
ResizeContents(Document, ContentsResizeParameters)Изменяет размер страниц документа. Пустые поля добавляются вокруг уменьшенной страницы.
ResizeContents(Document, int[], ContentsResizeParameters)Изменяет размер страниц документа. Пустые поля добавляются вокруг уменьшенной страницы.
ResizeContents(Stream, Stream, int[], ContentsResizeParameters)Изменяет содержимое страниц документа.
ResizeContents(string, string, int[], ContentsResizeParameters)Изменяет содержимое страниц документа. Если страница уменьшена, пустые поля добавляются вокруг страницы.
ResizeContents(Stream, Stream, int[], double, double)Изменяет содержимое страниц документа. Уменьшает содержимое страницы и добавляет поля. Новый размер содержимого указан в единицах измерения по умолчанию.
ResizeContents(string, string, int[], double, double)Изменяет содержимое страниц документа. Уменьшает содержимое страницы и добавляет поля. Новый размер содержимого указан в единицах измерения по умолчанию.
ResizeContentsPct(Stream, Stream, int[], double, double)Изменяет содержимое страниц документа. Уменьшает содержимое страницы и добавляет поля. Новый размер содержимого указан в процентах.
ResizeContentsPct(string, string, int[], double, double)Изменяет содержимое страниц документа. Уменьшает содержимое страницы и добавляет поля. Новый размер содержимого указан в процентах.
SplitFromFirst(Stream, int, Stream)Разделяет с начала до указанного места и сохраняет переднюю часть в выходной поток.
SplitFromFirst(string, int, string)Разделяет PDF файл с первой страницы до указанного места и сохраняет переднюю часть как новый файл.
SplitToBulks(Stream, int[][])Разделяет PDF файл на несколько документов. Документы могут быть одностраничными или многопстраничными.
SplitToBulks(string, int[][])Разделяет PDF файл на несколько документов. Документы могут быть одностраничными или многопстраничными.
SplitToEnd(Stream, int, Stream)Разделяет с указанного места и сохраняет заднюю часть как новый файл Stream.
SplitToEnd(string, int, string)Разделяет с места и сохраняет заднюю часть как новый файл.
SplitToPages(Stream)Разделяет PDF файл на одностраничные документы.
SplitToPages(string)Разделяет PDF файл на одностраничные документы.
SplitToPages(Stream, string)Разделяет PDF файл на одностраничные документы и сохраняет его в указанном пути. Путь указывается по шаблону имени поля.
SplitToPages(string, string)Разделяет PDF файл на одностраничные документы и сохраняет его в указанном пути. Путь указывается по шаблону имени поля.
TryAppend(Stream, Stream[], int, int, Stream)Добавляет страницы, выбранные из массива документов в portStreams. Результирующий документ включает firstInputFile и все страницы документов portStreams в диапазоне startPage до endPage.
TryAppend(string, string[], int, int, string)Добавляет страницы, выбранные из документов portFiles. Результирующий документ включает firstInputFile и все страницы документов portFiles в диапазоне startPage до endPage.
TryConcatenate(Document[], Document)Конкатенирует документы.
TryConcatenate(Stream[], Stream)Конкатенирует файлы.
TryConcatenate(string[], string)Конкатенирует файлы в один файл.
TryConcatenate(string, string, string)Конкатенирует два файла.
TryConcatenate(Stream, Stream, Stream, Stream)Объединяет два PDF документа в новый PDF документ с чередующимися страницами и заполняет пустые места пустыми страницами. Например: document1 имеет 5 страниц: p1, p2, p3, p4, p5. document2 имеет 3 страницы: p1’, p2’, p3’. Объединение двух PDF документов приведет к результату с страницами: p1, p1’, p2, p2’, p3, p3’, p4, blankpage, p5, blankpage.
TryConcatenate(string, string, string, string)Объединяет два PDF документа в новый PDF документ с чередующимися страницами и заполняет пустые места пустыми страницами. Например: document1 имеет 5 страниц: p1, p2, p3, p4, p5. document2 имеет 3 страницы: p1’, p2’, p3’. Объединение двух PDF документов приведет к результату с страницами: p1, p1’, p2, p2’, p3, p3’, p4, blankpage, p5, blankpage.
TryDelete(Stream, int[], Stream)Удаляет страницы, указанные массивом номеров, из входного файла, сохраняет как новый PDF файл.
TryDelete(string, int[], string)Удаляет страницы, указанные массивом номеров, из входного файла, сохраняет как новый PDF файл.
TryExtract(Stream, int[], Stream)Извлекает страницы, указанные массивом номеров, сохраняет как новый PDF файл.
TryExtract(string, int[], string)Извлекает страницы, указанные массивом номеров, сохраняет как новый PDF файл.
TryExtract(string, int, int, string)Извлекает страницы из входного файла, сохраняет как новый PDF файл.
TryInsert(Stream, int, Stream, int[], Stream)Вставляет страницы из другого файла в входной PDF файл.
TryInsert(string, int, string, int[], string)Вставляет страницы из другого файла в входной PDF файл.
TryMakeBooklet(Stream, Stream)Создает буклет из InputStream в outputStream.
TryMakeBooklet(string, string)Создает буклет из входного файла в выходной файл.
TryMakeBooklet(Stream, Stream, PageSize)Создает буклет из входного потока и сохраняет результат в выходной поток.
TryMakeBooklet(string, string, PageSize)Создает буклет из inputFile в outputFile.
TryMakeBooklet(Stream, Stream, int[], int[])Создает индивидуальный буклет из firstInputStream в outputStream.
TryMakeBooklet(string, string, int[], int[])Создает индивидуальный буклет из firstInputFile в outputFile.
TryMakeBooklet(Stream, Stream, PageSize, int[], int[])Создает буклет из firstInputStream в outputStream.
TryMakeBooklet(string, string, PageSize, int[], int[])Создает индивидуальный буклет из firstInputFile в outputFile.
TryMakeNUp(Stream, Stream, Stream)Создает документ N-Up из двух входных PDF потоков в outputStream.
TryMakeNUp(Stream[], Stream, bool)Создает документ N-Up из нескольких входных PDF потоков в outputStream. Каждая страница outputStream будет содержать несколько страниц, которые являются комбинацией страниц во входных потоках с одинаковым номером страницы. Многостраничные документы укладываются горизонтально, если isSidewise равно true, и вертикально, если isSidewise равно false.
TryMakeNUp(string, string, string)Создает документ N-Up из двух входных PDF файлов в outputFile. Каждая страница outputFile будет содержать две страницы, одна страница из первого входного файла и другая из второго входного файла. Две страницы укладываются горизонтально.
TryMakeNUp(string[], string, bool)Создает документ N-Up из нескольких входных PDF файлов в outputFile. Каждая страница outputFile будет содержать несколько страниц, которые являются комбинацией страниц во входных файлах с одинаковым номером страницы. Многостраничные документы укладываются горизонтально, если isSidewise равно true, и вертикально, если isSidewise равно false.
TryMakeNUp(Stream, Stream, int, int)Создает документ N-Up из входного потока и сохраняет результат в выходной поток.
TryMakeNUp(string, string, int, int)Создает документ N-Up из firstInputFile в outputFile.
TryMakeNUp(Stream, Stream, int, int, PageSize)Создает документ N-Up из первого входного потока в выходной поток.
TryMakeNUp(string, string, int, int, PageSize)Создает документ N-Up из входного файла в outputFile.
TryResizeContents(Stream, Stream, int[], ContentsResizeParameters)Изменяет размер содержимого страниц документа.
TryResizeContents(string, string, int[], ContentsResizeParameters)Изменяет размер содержимого страниц в документе. Если страница уменьшена, пустые поля добавляются вокруг страницы.
TryResizeContents(Stream, Stream, int[], double, double)Изменяет размер содержимого страниц документа. Уменьшает содержимое страницы и добавляет поля. Новый размер содержимого указан в единицах измерения по умолчанию.
TrySplitFromFirst(Stream, int, Stream)Разделяет с начала до указанного места и сохраняет переднюю часть в выходной поток.
TrySplitFromFirst(string, int, string)Разделяет PDF файл с первой страницы до указанного места и сохраняет переднюю часть как новый файл.
TrySplitToEnd(Stream, int, Stream)Разделяет с указанного места и сохраняет заднюю часть как новый файл Stream.
TrySplitToEnd(string, int, string)Разделяет с места и сохраняет заднюю часть как новый файл.

Другие члены

ИмяОписание
enum ConcatenateCorruptedFileActionДействие, выполняемое при встрече поврежденного файла в процессе конкатенации.
class ContentsResizeParametersКласс для указания параметров изменения размера страницы. Позволяет установить следующие параметры: размер результирующей страницы (ширина, высота) в единицах измерения по умолчанию или в процентах от начального размера страниц; левое, верхнее, нижнее и правое поля в единицах измерения по умолчанию или в процентах от начального размера страницы; некоторые значения могут быть оставлены пустыми для автоматического расчета. Эти значения будут рассчитаны из остатка размера страницы после явного указания значений. Например: если ширина страницы = 100 и новый размер страницы указан 60 единиц, то левое и правое поля автоматически рассчитываются: (100 - 60) / 2 = 15. Этот класс используется в методе ResizeContents.
class ContentsResizeValueЗначение поля или размера содержимого, указанное в процентах от единиц измерения по умолчанию. Этот класс используется в ContentsResizeParameters.
class CorruptedItemКласс, который предоставляет информацию о поврежденных файлах во время конкатенации.
class PageBreakДанные о позиции разрыва страницы.

См. также