Class Document

Class Document

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

Classe que representa um documento PDF

public sealed class Document : IDisposable

Herança

objectDocument

Implementa

IDisposable

Membros Herdados

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

Construtores

Document(Stream)

Inicializa uma nova instância de Document a partir do fluxo input.

public Document(Stream input)

Parâmetros

input Stream

Fluxo com o documento pdf.

Document(Stream, string, bool)

Inicializa uma nova instância de Document a partir do fluxo input.

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

Parâmetros

input Stream

Fluxo com o documento pdf.

password string

Senha de usuário ou proprietário.

isManagedStream bool

se definido como true, o fluxo interno é fechado antes da saída; caso contrário, não é.

Document(Stream, bool)

Inicializa uma nova instância de Document a partir do fluxo input.

public Document(Stream input, bool isManagedStream)

Parâmetros

input Stream

Fluxo com o documento pdf.

isManagedStream bool

se definido como true, o fluxo interno é fechado antes da saída; caso contrário, não é.

Document(string)

Apenas inicializa o Document usando filename. O mesmo que Aspose.Pdf.Document.#ctor(System.IO.Stream).

public Document(string filename)

Parâmetros

filename string

O nome do arquivo do documento pdf.

Document(Stream, string)

Inicializa uma nova instância de Document a partir do fluxo input.

public Document(Stream input, string password)

Parâmetros

input Stream

Objeto de fluxo de entrada, o pdf está protegido por senha.

password string

Senha de usuário ou proprietário.

Document()

Inicializa um documento vazio.

public Document()

Document(string, string)

Inicializa uma nova instância da classe Aspose.Pdf.Document para trabalhar com documentos criptografados.

public Document(string filename, string password)

Parâmetros

filename string

Nome do arquivo do documento.

password string

Senha de usuário ou proprietário.

Document(string, string, bool)

Inicializa uma nova instância da classe Aspose.Pdf.Document para trabalhar com documentos criptografados.

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

Parâmetros

filename string

Nome do arquivo do documento.

password string

Senha de usuário ou proprietário.

isManagedStream bool

se definido como true, o fluxo interno é fechado antes da saída; caso contrário, não é.

Document(string, LoadOptions)

Abre um documento existente de um arquivo fornecendo as opções de conversão necessárias para obter o documento pdf.

public Document(string filename, LoadOptions options)

Parâmetros

filename string

Arquivo de entrada para converter em documento pdf.

options LoadOptions

Representa propriedades para converter filename em documento pdf.

Document(Stream, LoadOptions)

Abre um documento existente de um fluxo fornecendo as opções de conversão necessárias para obter o documento pdf.

public Document(Stream input, LoadOptions options)

Parâmetros

input Stream

Fluxo de entrada para converter em documento pdf.

options LoadOptions

Representa propriedades para converter input em documento pdf.

Campos

DefaultNodesNumInSubtrees

public const byte DefaultNodesNumInSubtrees = 10

Valor do Campo

byte

Propriedades

Actions

Obtém as ações do documento. Esta propriedade é uma instância da classe DocumentActions que permite obter definir ações BeforClosing, BeforSaving, etc.

public DocumentActionCollection Actions { get; }

Valor da Propriedade

DocumentActionCollection

Exemplos

Este exemplo demonstra como obter a ação após abrir o documento:

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

Permite mesclar conteúdos de página para otimizar o tamanho do documento. Se usado, páginas diferentes, mas duplicadas podem referenciar o mesmo objeto de conteúdo. Observe que este modo pode causar efeitos colaterais, como a alteração do conteúdo da página quando outra página é alterada.

public bool AllowReusePageContent { get; set; }

Valor da Propriedade

bool

Background

Obtém ou define a cor de fundo do documento.

public Color Background { get; set; }

Valor da Propriedade

Color

CenterWindow

Obtém ou define a flag que especifica se a posição da janela do documento será centralizada na tela.

public bool CenterWindow { get; set; }

Valor da Propriedade

bool

Exemplos

O exemplo demonstra como obter a flag CenterWindow:

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

Collection

Obtém a coleção do documento.

public Collection Collection { get; set; }

Valor da Propriedade

Collection

CryptoAlgorithm

Obtém as configurações de segurança se o documento estiver criptografado. Se o documento não estiver criptografado, a exceção correspondente será levantada no .net 1.1 ou CryptoAlgorithm será nulo para outras versões do .net.

public CryptoAlgorithm? CryptoAlgorithm { get; }

Valor da Propriedade

CryptoAlgorithm?

Destinations

Obtém a coleção de destinos. Obsoleto. Por favor, use NamedDestinations.

public DestinationCollection Destinations { get; }

Valor da Propriedade

DestinationCollection

Direction

Obtém ou define a ordem de leitura do texto: L2R (da esquerda para a direita) ou R2L (da direita para a esquerda).

public Direction Direction { get; set; }

Valor da Propriedade

Direction

DisableFontLicenseVerifications

Muitas operações com fontes não podem ser executadas se essas operações forem proibidas pela licença dessa fonte. Por exemplo, algumas fontes não podem ser incorporadas em documentos PDF se as regras de licença desativarem a incorporação para essa fonte. Essa flag é usada para desativar quaisquer restrições de licença para todas as fontes no documento PDF atual. Tenha cuidado ao usar essa flag. Quando ela é definida, significa que a pessoa que define essa flag, assume toda a responsabilidade por possíveis violações de licença/lei. Portanto, assume isso por conta e risco. Recomenda-se fortemente usar essa flag apenas quando você estiver totalmente confiante de que não está infringindo a lei de direitos autorais. Por padrão, falso.

public bool DisableFontLicenseVerifications { get; set; }

Valor da Propriedade

bool

DisplayDocTitle

Obtém ou define a flag que especifica se a barra de título da janela do documento deve exibir o título do documento.

public bool DisplayDocTitle { get; set; }

Valor da Propriedade

bool

Exemplos

O exemplo demonstra como obter a flag DisplayDocTitle:

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

Duplex

Obtém ou define a opção de manuseio do modo duplex de impressão a ser usada ao imprimir o arquivo a partir da caixa de diálogo de impressão.

public PrintDuplex Duplex { get; set; }

Valor da Propriedade

PrintDuplex

EmbedStandardFonts

Propriedade que declara que o documento deve incorporar todas as fontes padrão Type1 que têm a flag IsEmbedded definida como verdadeira. Todas as fontes PDF podem ser incorporadas no documento simplesmente definindo a flag IsEmbedded como verdadeira, mas as fontes padrão Type1 do PDF são uma exceção a essa regra. A incorporação de fontes padrão Type1 requer muito tempo, portanto, para incorporar essas fontes, é necessário não apenas definir a flag IsEmbedded como verdadeira para a fonte especificada, mas também definir uma flag adicional no nível do documento - EmbedStandardFonts = true; Essa propriedade pode ser definida apenas uma vez para todas as fontes. Por padrão, falso.

public bool EmbedStandardFonts { get; set; }

Valor da Propriedade

bool

EmbeddedFiles

Obtém a coleção de arquivos incorporados ao documento.

public EmbeddedFileCollection EmbeddedFiles { get; }

Valor da Propriedade

EmbeddedFileCollection

EnableObjectUnload

Obtém ou define a flag que permite que o documento seja descarregado parcialmente da memória. Isso permite reduzir o uso de memória, mas pode ter um efeito negativo no desempenho.

public bool EnableObjectUnload { get; set; }

Valor da Propriedade

bool

EnableSignatureSanitization

Obtém ou define a flag para gerenciar a sanitização dos campos de assinatura. Habilitado por padrão.

public bool EnableSignatureSanitization { get; set; }

Valor da Propriedade

bool

FileName

Nome do arquivo PDF que causou este documento

public string FileName { get; }

Valor da Propriedade

string

FitWindow

Obtém ou define a flag que especifica se a janela do documento deve ser redimensionada para se ajustar à primeira página exibida.

public bool FitWindow { get; set; }

Valor da Propriedade

bool

Exemplos

O exemplo abaixo demonstra como obter a flag FitWindow:

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

FontUtilities

Instância de IDocumentFontUtilities

public Document.IDocumentFontUtilities FontUtilities { get; }

Valor da Propriedade

Document.IDocumentFontUtilities

Form

Obtém o Acro Form do documento.

public Form Form { get; }

Valor da Propriedade

Form

HandleSignatureChange

Lança uma Exceção se o documento for salvo com alterações e tiver assinatura

public bool HandleSignatureChange { get; set; }

Valor da Propriedade

bool

HideMenubar

Obtém ou define a flag que especifica se a barra de menu deve ser oculta quando o documento estiver ativo.

public bool HideMenubar { get; set; }

Valor da Propriedade

bool

Exemplos

O exemplo demonstra como obter a flag HideMenubar:

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

HideToolBar

Obtém ou define a flag que especifica se a barra de ferramentas deve ser oculta quando o documento estiver ativo.

public bool HideToolBar { get; set; }

Valor da Propriedade

bool

Exemplos

O exemplo demonstra como obter a flag HideToolBar:

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

HideWindowUI

Obtém ou define a flag que especifica se os elementos da interface do usuário devem ser ocultados quando o documento estiver ativo.

public bool HideWindowUI { get; set; }

Valor da Propriedade

bool

Exemplos

O exemplo demonstra como obter a flag HideWindowUI:

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

Id

Obtém o ID.

public Id Id { get; }

Valor da Propriedade

Id

IgnoreCorruptedObjects

Obtém ou define a flag de ignorar erros em arquivos de origem. Quando páginas do documento de origem são copiadas para o documento de destino, o processo de cópia é interrompido com exceção se alguns objetos nos arquivos de origem estiverem corrompidos quando essa flag for falsa. exemplo: dest.Pages.Add(src.Pages); Se essa flag for definida como verdadeira, os objetos corrompidos serão substituídos por valores vazios. Por padrão: verdadeiro.

public bool IgnoreCorruptedObjects { get; set; }

Valor da Propriedade

bool

Info

Obtém as informações do documento.

public DocumentInfo Info { get; }

Valor da Propriedade

DocumentInfo

IsEncrypted

Obtém o status de criptografia do documento. Verdadeiro se o documento estiver criptografado.

public bool IsEncrypted { get; }

Valor da Propriedade

bool

IsLicensed

Obtém o estado licenciado do sistema. Retorna verdadeiro se o sistema estiver funcionando no modo licenciado e falso caso contrário.

public static bool IsLicensed { get; }

Valor da Propriedade

bool

IsLinearized

Obtém ou define um valor que indica se o documento está linearizado.

public bool IsLinearized { get; set; }

Valor da Propriedade

bool

IsPdfUaCompliant

Obtém se o documento é compatível com pdfua.

public bool IsPdfUaCompliant { get; }

Valor da Propriedade

bool

IsPdfaCompliant

Obtém se o documento é compatível com pdfa.

public bool IsPdfaCompliant { get; }

Valor da Propriedade

bool

IsXrefGapsAllowed

Obtém ou define se o documento permite lacunas de xref.

public bool IsXrefGapsAllowed { get; set; }

Valor da Propriedade

bool

JavaScript

Coleção de JavaScript de nível de documento.

public JavaScriptCollection JavaScript { get; }

Valor da Propriedade

JavaScriptCollection

LogicalStructure

Obtém a estrutura lógica do documento.

public RootElement LogicalStructure { get; }

Valor da Propriedade

RootElement

Metadata

Metadados do documento. (Um documento PDF pode incluir informações gerais, como o título do documento, autor e datas de criação e modificação. Essas informações globais sobre o documento (em oposição ao seu conteúdo ou estrutura) são chamadas de metadados e têm como objetivo ajudar na catalogação e na busca de documentos em bancos de dados externos.)

public Metadata Metadata { get; }

Valor da Propriedade

Metadata

NamedDestinations

Coleção de Destinos Nomeados no documento.

public NamedDestinationCollection NamedDestinations { get; }

Valor da Propriedade

NamedDestinationCollection

NonFullScreenPageMode

Obtém ou define o modo de página, especificando como exibir o documento ao sair do modo de tela cheia.

public PageMode NonFullScreenPageMode { get; set; }

Valor da Propriedade

PageMode

OpenAction

Obtém ou define a ação realizada ao abrir o documento.

public IAppointment OpenAction { get; set; }

Valor da Propriedade

IAppointment

Exemplos

O exemplo demonstra como obter a flag CenterWindow:

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

OptimizeSize

Obtém ou define a flag de otimização. Quando páginas são adicionadas ao documento, fluxos de recursos iguais no arquivo resultante são mesclados em um objeto PDF se essa flag estiver definida. Isso permite reduzir o tamanho do arquivo resultante, mas pode causar uma execução mais lenta e maiores requisitos de memória. Valor padrão: falso.

public bool OptimizeSize { get; set; }

Valor da Propriedade

bool

Outlines

Obtém os contornos do documento.

public OutlineCollection Outlines { get; }

Valor da Propriedade

OutlineCollection

OutputIntents

Obtém a coleção de Intenções de Saída no documento.

public OutputIntents OutputIntents { get; }

Valor da Propriedade

OutputIntents

PageInfo

Obtém ou define as informações da página. (apenas para gerador, não preenchido ao ler o documento)

public PageInfo PageInfo { get; set; }

Valor da Propriedade

PageInfo

PageLabels

Obtém os rótulos das páginas no documento.

public PageLabelCollection PageLabels { get; }

Valor da Propriedade

PageLabelCollection

PageLayout

Obtém ou define o layout da página que deve ser usado quando o documento for aberto.

public PageLayout PageLayout { get; set; }

Valor da Propriedade

PageLayout

PageMode

Obtém ou define o modo de página, especificando como o documento deve ser exibido quando aberto.

public PageMode PageMode { get; set; }

Valor da Propriedade

PageMode

Pages

Obtém ou define a coleção de páginas do documento. Observe que as páginas são numeradas a partir de 1 na coleção.

public PageCollection Pages { get; }

Valor da Propriedade

PageCollection

Exemplos

O exemplo abaixo demonstra como operar com as páginas do documento: Como obter o número de páginas e como obter o retângulo da página inicial do documento.

Aspose.Pdf.Document document = new Aspose.Pdf.Document("sample.pdf");
Aspose.Pdf.PageCollection pages = document.Pages;
System.Console.WriteLine("O documento contém " + pages.Count);
Page page = pages[1];
Rectangle rect = page.Rect;

PdfFormat

Obtém o formato PDF

public PdfFormat PdfFormat { get; }

Valor da Propriedade

PdfFormat

Permissions

Obtém as permissões do documento.

public int Permissions { get; }

Valor da Propriedade

int

PickTrayByPdfSize

Obtém ou define uma flag que especifica se o tamanho da página PDF deve ser usado para selecionar a bandeja de papel de entrada.

public bool PickTrayByPdfSize { get; set; }

Valor da Propriedade

bool

PrintScaling

Obtém ou define a opção de escalonamento de página que deve ser selecionada quando uma caixa de diálogo de impressão é exibida para este documento.

public PrintScaling PrintScaling { get; set; }

Valor da Propriedade

PrintScaling

TaggedContent

Obtém acesso ao conteúdo TaggedPdf.

public ITaggedContent TaggedContent { get; }

Valor da Propriedade

ITaggedContent

Exemplos

O exemplo demonstra como usar o conteúdo marcado para criar um novo documento com cabeçalho, parágrafos e imagens.

// Cria um novo documento
Document document = new Document();

// Obtém o conteúdo marcado
ITaggedContent taggedContent = document.TaggedContent;

// Define o idioma para o documento
taggedContent.SetLanguage("en-US");

// Define o título para o documento PDF
taggedContent.SetTitle("Documento de exemplo");

// Criando e adicionando Seção
SectElement sect = taggedContent.CreateSectElement();
taggedContent.RootElement.AppendChild(sect);

// Cria Cabeçalho
HeaderElement h1 = taggedContent.CreateHeaderElement(1);
h1.SetText("O Cabeçalho");
sect.AppendChild(h1);

// Cria parágrafo
ParagraphElement p = taggedContent.CreateParagraphElement();
p.SetTag("Parágrafo");
p.SetText("O texto do parágrafo.");
sect.AppendChild(p);

// Cria ilustração
IllustrationElement figure1 = taggedContent.CreateFigureElement();
sect.AppendChild(figure1);
figure1.AlternativeText = "Figura 1";
figure1.Title = "Imagem 1";
figure1.SetTag("Fig");
figure1.SetImage("caminho/da/imagem.jpg");

// Salva o documento
document.Save("exemplo.pdf");

Version

Obtém uma versão do Pdf do cabeçalho do arquivo Pdf.

public string Version { get; }

Valor da Propriedade

string

Métodos

BindXml(string)

Vincula xml ao documento

public void BindXml(string file)

Parâmetros

file string

O arquivo xml

BindXml(string, string)

Vincula xml/xsl ao documento

public void BindXml(string xmlFile, string xslFile)

Parâmetros

xmlFile string

O arquivo xml.

xslFile string

O arquivo xsl se XSLT for usado.

BindXml(Stream, Stream)

Vincula xml/xsl ao documento

public void BindXml(Stream xmlStream, Stream xslStream)

Parâmetros

xmlStream Stream

O fluxo xml.

xslStream Stream

O fluxo xsl se XSLT for usado.

BindXml(Stream, Stream, XmlReaderSettings)

Vincula xml/xsl ao documento

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

Parâmetros

xmlStream Stream

O fluxo xml.

xslStream Stream

O fluxo xsl se XSLT for usado.

settings XmlReaderSettings

As configurações do leitor xml.

BindXml(Stream)

Vincula xml ao documento

public void BindXml(Stream stream)

Parâmetros

stream Stream

O fluxo xml.

ChangePasswords(string, string, string)

Altera as senhas do documento. Esta ação pode ser realizada apenas usando a senha do proprietário.

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

Parâmetros

ownerPassword string

Senha do proprietário.

newUserPassword string

Nova senha de usuário.

newOwnerPassword string

Nova senha do proprietário.

Check(bool)

Valida o documento.

public bool Check(bool doRepair)

Parâmetros

doRepair bool

Se verdadeiro, os problemas encontrados serão reparados.

Retorna

bool

Verdadeiro - se o documento foi reparado; caso contrário, falso.

Convert(string, PdfFormat, ConvertErrorAction, ConvertTransparencyAction)

Converte o documento e salva os erros no arquivo especificado.

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

Parâmetros

outputLogFileName string

Caminho para o arquivo onde os comentários serão armazenados.

format PdfFormat

O formato pdf.

action ConvertErrorAction

Ação para objetos que não podem ser convertidos.

transparencyAction ConvertTransparencyAction

Ação para objetos de imagem mascarados.

Retorna

bool

O resultado da operação.

Convert(Stream, PdfFormat, ConvertErrorAction, ConvertTransparencyAction)

Converte o documento e salva os erros no arquivo especificado.

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

Parâmetros

outputLogStream Stream

Fluxo onde os comentários serão armazenados.

format PdfFormat

O formato pdf.

action ConvertErrorAction

Ação para objetos que não podem ser convertidos.

transparencyAction ConvertTransparencyAction

Ação para objetos de imagem mascarados.

Retorna

bool

O resultado da operação.

Convert(string, PdfFormat, ConvertErrorAction)

Converte o documento e salva os erros no arquivo especificado.

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

Parâmetros

outputLogFileName string

Caminho para o arquivo onde os comentários serão armazenados.

format PdfFormat

O formato pdf.

action ConvertErrorAction

Ação para objetos que não podem ser convertidos.

Retorna

bool

O resultado da operação.

Convert(PdfFormatConversionOptions)

Converte o documento usando as opções de conversão especificadas.

public bool Convert(PdfFormatConversionOptions options)

Parâmetros

options PdfFormatConversionOptions

conjunto de opções para converter o documento PDF.

Retorna

bool

O resultado da operação.

Convert(CallBackGetHocrWithPage, bool)

Reconhece imagens dentro do documento e adiciona strings hocr sobre elas.

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

Parâmetros

callback Document.CallBackGetHocrWithPage

Ação para imagens que serão processadas pelo reconhecimento hocr.

flattenImages bool

O texto nas imagens pdf pode ser pintado usando a mecânica de máscaras, nesse caso as imagens devem ser achatadas.

Retorna

bool

O resultado da operação. Se não houver imagens no documento, retorna falso.

Convert(CallBackGetHocr, bool)

Reconhece imagens dentro do documento e adiciona strings hocr sobre elas.

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

Parâmetros

callback Document.CallBackGetHocr

Ação para imagens que serão processadas pelo reconhecimento hocr.

flattenImages bool

O texto nas imagens pdf pode ser pintado usando a mecânica de máscaras, nesse caso as imagens devem ser achatadas.

Retorna

bool

O resultado da operação. Se não houver imagens no documento, retorna falso.

Convert(Stream, PdfFormat, ConvertErrorAction)

Converte o documento e salva os erros no fluxo especificado.

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

Parâmetros

outputLogStream Stream

Fluxo onde os comentários serão armazenados.

format PdfFormat

Formato pdf.

action ConvertErrorAction

Ação para objetos que não podem ser convertidos.

Retorna

bool

O resultado da operação.

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

Converte o documento aplicando o Fixup.

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

Parâmetros

fixup Fixup

O tipo de Fixup.

outputLog Stream

O log do processo.

onlyValidation bool

Apenas validação do documento.

parameters object[]

Propriedades para Fixup que não podem ser definidas.

Retorna

bool

O resultado da operação.

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

Converte o documento aplicando o Fixup.

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

Parâmetros

fixup Fixup

O tipo de Fixup.

outputLog string

O log do processo.

onlyValidation bool

Apenas validação do documento.

parameters object[]

Propriedades para Fixup que não podem ser definidas.

Retorna

bool

O resultado da operação.

Convert(string, LoadOptions, string, SaveOptions)

Converte o arquivo de origem no formato de origem para o arquivo de destino no formato de destino.

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

Parâmetros

srcFileName string

O nome do arquivo de origem.

loadOptions LoadOptions

O formato do arquivo de origem.

dstFileName string

O nome do arquivo de destino.

saveOptions SaveOptions

O formato do arquivo de destino.

Convert(Stream, LoadOptions, string, SaveOptions)

Converte o fluxo no formato de origem para o arquivo de destino no formato de destino.

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

Parâmetros

srcStream Stream

O fluxo de origem.

loadOptions LoadOptions

O formato do fluxo de origem.

dstFileName string

O nome do arquivo de destino.

saveOptions SaveOptions

O formato do arquivo de destino.

Convert(string, LoadOptions, Stream, SaveOptions)

Converte o arquivo de origem no formato de origem para o fluxo no formato de destino.

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

Parâmetros

srcFileName string

O nome do arquivo de origem.

loadOptions LoadOptions

O formato do arquivo de origem.

dstStream Stream

O fluxo de destino.

saveOptions SaveOptions

O formato do fluxo de destino.

Convert(Stream, LoadOptions, Stream, SaveOptions)

Converte o fluxo no formato de origem para o fluxo no formato de destino.

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

Parâmetros

srcStream Stream

O fluxo de origem.

loadOptions LoadOptions

O formato do fluxo de origem.

dstStream Stream

O fluxo de destino.

saveOptions SaveOptions

O formato do arquivo de destino.

ConvertPageToPNGMemoryStream(Page)

Converte a página para PNG para DSR, OMR, fluxo de imagem OCR.

public MemoryStream ConvertPageToPNGMemoryStream(Page page)

Parâmetros

page Page

Página a ser convertida.

Retorna

MemoryStream

Fluxo de imagem.

Decrypt()

Descriptografa o documento. Chame então Save para obter a versão descriptografada do documento.

public void Decrypt()

Dispose()

Fecha todos os recursos usados por este documento.

public void Dispose()

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

Criptografa o documento. Chame então Save para obter a versão criptografada do documento.

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

Parâmetros

userPassword string

Senha do usuário.

ownerPassword string

Senha do proprietário.

privileges DocumentPrivilege

Permissões do documento, veja Aspose.Pdf.Document.Permissions para detalhes.

cryptoAlgorithm CryptoAlgorithm

Algoritmo criptográfico, veja Aspose.Pdf.Document.CryptoAlgorithm para detalhes.

usePdf20 bool

Suporte para a revisão 6 (Extensão 8).

Encrypt(string, string, Permissions, CryptoAlgorithm)

Criptografa o documento. Chame então Save para obter a versão criptografada do documento.

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

Parâmetros

userPassword string

Senha do usuário.

ownerPassword string

Senha do proprietário.

permissions Permissions

Permissões do documento, veja Aspose.Pdf.Document.Permissions para detalhes.

cryptoAlgorithm CryptoAlgorithm

Algoritmo criptográfico, veja Aspose.Pdf.Document.CryptoAlgorithm para detalhes.

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

Criptografa o documento. Chame então Save para obter a versão criptografada do documento.

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

Parâmetros

userPassword string

Senha do usuário.

ownerPassword string

Senha do proprietário.

permissions Permissions

Permissões do documento, veja Aspose.Pdf.Document.Permissions para detalhes.

cryptoAlgorithm CryptoAlgorithm

Algoritmo criptográfico, veja Aspose.Pdf.Document.CryptoAlgorithm para detalhes.

usePdf20 bool

Suporte para a revisão 6 (Extensão 8).

ExportAnnotationsToXfdf(string)

Exporta todas as anotações do documento para um arquivo XFDF

public void ExportAnnotationsToXfdf(string fileName)

Parâmetros

fileName string

Nome do arquivo XFDF

ExportAnnotationsToXfdf(Stream)

Exporta todas as anotações do documento para o fluxo.

public void ExportAnnotationsToXfdf(Stream stream)

Parâmetros

stream Stream

Fluxo onde armazenar XFDF.

Flatten()

Remove todos os campos do documento e coloca seus valores no lugar.

public void Flatten()

Flatten(FlattenSettings)

Remove todos os campos (e anotações) do documento e coloca seus valores no lugar.

public void Flatten(Form.FlattenSettings flattenSettings)

Parâmetros

flattenSettings Form.FlattenSettings

Configurações para o processo de achatamento.

FlattenTransparency()

Substitui o conteúdo transparente por gráficos raster e vetoriais não transparentes.

public void FlattenTransparency()

FreeMemory()

Limpa a memória

public void FreeMemory()

GetCatalogValue(string)

Retorna o valor do item do dicionário de catálogo.

public object GetCatalogValue(string key)

Parâmetros

key string

A chave do item.

Retorna

object

Valor do item - se a chave foi encontrada com sucesso; caso contrário, nulo.

GetObjectById(string)

Obtém um objeto com o ID especificado no documento.

public object GetObjectById(string id)

Parâmetros

id string

O id do objeto.

Retorna

object

O objeto com o id especificado. Nulo se o id não for encontrado.

GetXmpMetadata(Stream)

Obtém os metadados XMP do documento.

public void GetXmpMetadata(Stream stream)

Parâmetros

stream Stream

Fluxo onde os metadados serão armazenados.

HasIncrementalUpdate()

Verifica se o documento PDF atual foi salvo com atualizações incrementais.

public bool HasIncrementalUpdate()

Retorna

bool

true se o documento PDF tiver atualizações incrementais; caso contrário, false.

ImportAnnotationsFromXfdf(string)

Importa anotações do arquivo XFDF para o documento.

public void ImportAnnotationsFromXfdf(string fileName)

Parâmetros

fileName string

Nome do arquivo XFDF

ImportAnnotationsFromXfdf(Stream)

Importa anotações do fluxo para o documento.

public void ImportAnnotationsFromXfdf(Stream stream)

Parâmetros

stream Stream

Fluxo que contém dados XFDF.

LoadFrom(string, LoadOptions)

Carrega um arquivo, convertendo-o para PDF.

public void LoadFrom(string filename, LoadOptions options)

Parâmetros

filename string

O caminho para o arquivo a ser aberto.

options LoadOptions

As opções de carregamento.

Exceções

PdfException

Se o arquivo não puder ser carregado.

FileNotFoundException

Se o arquivo não for encontrado.

Merge(MergeOptions, params Document[])

Mescla documentos.

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

Parâmetros

mergeOptions Document.MergeOptions

As opções de mesclagem.

documents Document[]

Os documentos a serem mesclados.

Merge(MergeOptions, params string[])

Mescla documentos.

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

Parâmetros

mergeOptions Document.MergeOptions

As opções de mesclagem.

files string[]

Os arquivos pdf a serem mesclados.

Merge(params Document[])

Mescla documentos.

public void Merge(params Document[] documents)

Parâmetros

documents Document[]

Os documentos a serem mesclados.

Merge(params string[])

Mescla arquivos pdf.

public void Merge(params string[] files)

Parâmetros

files string[]

Os arquivos pdf a serem mesclados.

MergeDocuments(MergeOptions, params string[])

Mescla documentos.

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

Parâmetros

mergeOptions Document.MergeOptions

As opções de mesclagem.

files string[]

Os arquivos pdf a serem mesclados.

Retorna

Document

O documento mesclado.

MergeDocuments(MergeOptions, params Document[])

Mescla documentos.

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

Parâmetros

mergeOptions Document.MergeOptions

files Document[]

Os documentos a serem mesclados.

Retorna

Document

O documento mesclado.

MergeDocuments(params string[])

Mescla arquivos pdf.

public static Document MergeDocuments(params string[] files)

Parâmetros

files string[]

Os arquivos pdf a serem mesclados.

Retorna

Document

O documento mesclado.

MergeDocuments(params Document[])

Mescla documentos.

public static Document MergeDocuments(params Document[] documents)

Parâmetros

documents Document[]

Os documentos a serem mesclados.

Retorna

Document

O documento mesclado.

Optimize()

Lineariza o documento para

  • abrir a primeira página o mais rápido possível;
  • exibir a próxima página ou seguir um link para a próxima página o mais rápido possível;
  • exibir a página de forma incremental à medida que chega quando os dados de uma página são entregues por um canal lento (exibir os dados mais úteis primeiro);
  • permitir que a interação do usuário, como seguir um link, seja realizada mesmo antes que a página inteira tenha sido recebida e exibida. Invocar este método não salva realmente o documento. Pelo contrário, o documento é apenas preparado para ter uma estrutura otimizada, chame então Save para obter o documento otimizado.
public void Optimize()

OptimizeResources()

Otimize os recursos no documento:

  1. Recursos que não são usados nas páginas do documento são removidos;
  2. Recursos iguais são unidos em um objeto;
  3. Objetos não utilizados são excluídos.
public void OptimizeResources()

OptimizeResources(OptimizationOptions)

Otimize os recursos no documento de acordo com a estratégia de otimização definida.

public void OptimizeResources(OptimizationOptions strategy)

Parâmetros

strategy OptimizationOptions

Estratégia de otimização.

PageNodesToBalancedTree(byte)

Organiza os nós da árvore de páginas em um documento em uma árvore balanceada. Somente se o documento tiver mais de nodesNumInSubtrees objetos de página, caso contrário, não faz nada. Não chame este método enquanto itera sobre os elementos Pages, pode resultar em resultados imprevisíveis.

public void PageNodesToBalancedTree(byte nodesNumInSubtrees = 10)

Parâmetros

nodesNumInSubtrees byte

Número desejado de subnós. O valor padrão é dez.

ProcessParagraphs()

Processa parágrafos para o gerador.

public void ProcessParagraphs()

RemoveMetadata()

Remove metadados do documento.

public void RemoveMetadata()

RemovePdfUaCompliance()

Remove a conformidade pdfUa do documento.

public void RemovePdfUaCompliance()

RemovePdfaCompliance()

Remove a conformidade pdfa do documento.

public void RemovePdfaCompliance()

Repair()

Repara o documento quebrado.

public void Repair()

Save(Stream)

Armazena o documento no fluxo.

public void Save(Stream output)

Parâmetros

output Stream

Fluxo onde o documento deve ser armazenado.

Save(string)

Salva o documento no arquivo especificado.

public void Save(string outputFileName)

Parâmetros

outputFileName string

Caminho para o arquivo onde o documento será armazenado.

Save()

Salva o documento de forma incremental (ou seja, usando a técnica de atualização incremental).

public void Save()

Observações

Para salvar o documento de forma incremental, devemos abrir o arquivo do documento para gravação. Portanto, o Document deve ser inicializado com um fluxo gravável, como no próximo trecho de código: Document doc = new Document(new FileStream(“document.pdf”, FileMode.Open, FileAccess.ReadWrite)); // faça algumas alterações e salve o documento de forma incremental doc.Save();

Save(SaveOptions)

Salva o documento com opções de salvamento.

public void Save(SaveOptions options)

Parâmetros

options SaveOptions

Opções de salvamento.

Save(string, SaveFormat)

Salva o documento com um novo nome junto com um formato de arquivo.

public void Save(string outputFileName, SaveFormat format)

Parâmetros

outputFileName string

Caminho para o arquivo onde o documento será armazenado.

format SaveFormat

Opções de formato.

Save(Stream, SaveFormat)

Salva o documento com um novo nome junto com um formato de arquivo.

public void Save(Stream outputStream, SaveFormat format)

Parâmetros

outputStream Stream

Fluxo onde o documento será armazenado.

format SaveFormat

Opções de formato.

Exceções

ArgumentException

System.ArgumentException quando Aspose.Pdf.HtmlSaveOptions é passado para um método. Salvar um documento no fluxo html não é suportado. Por favor, use o método salvar para o arquivo.

Save(string, SaveOptions)

Salva o documento com um novo nome definindo suas opções de salvamento.

public void Save(string outputFileName, SaveOptions options)

Parâmetros

outputFileName string

Caminho para o arquivo onde o documento será armazenado.

options SaveOptions

Opções de salvamento.

Save(Stream, SaveOptions)

Salva o documento em um fluxo com opções de salvamento.

public void Save(Stream outputStream, SaveOptions options)

Parâmetros

outputStream Stream

Fluxo onde o documento será armazenado.

options SaveOptions

Opções de salvamento.

Exceções

ArgumentException

System.ArgumentException quando Aspose.Pdf.HtmlSaveOptions é passado para um método. Salvar um documento no fluxo html não é suportado. Por favor, use o método salvar para o arquivo.

SaveAsync(Stream, CancellationToken)

Armazena o documento no fluxo.

public Task SaveAsync(Stream output, CancellationToken cancellationToken)

Parâmetros

output Stream

Fluxo onde o documento deve ser armazenado.

cancellationToken CancellationToken

Token de cancelamento.

Retorna

Task

Tarefa assíncrona.

SaveAsync(string, CancellationToken)

Salva o documento no arquivo especificado.

public Task SaveAsync(string outputFileName, CancellationToken cancellationToken)

Parâmetros

outputFileName string

Caminho para o arquivo onde o documento será armazenado.

cancellationToken CancellationToken

Token de cancelamento.

Retorna

Task

Tarefa assíncrona.

SaveAsync(CancellationToken)

Salva o documento de forma incremental (ou seja, usando a técnica de atualização incremental).

public Task SaveAsync(CancellationToken cancellationToken)

Parâmetros

cancellationToken CancellationToken

Token de cancelamento.

Retorna

Task

Tarefa assíncrona.

Observações

Para salvar o documento de forma incremental, devemos abrir o arquivo do documento para gravação. Portanto, o Document deve ser inicializado com um fluxo gravável, como no próximo trecho de código: Document doc = new Document(new FileStream(“document.pdf”, FileMode.Open, FileAccess.ReadWrite)); // faça algumas alterações e salve o documento de forma incremental doc.Save();

SaveAsync(SaveOptions, CancellationToken)

Salva o documento com opções de salvamento.

public Task SaveAsync(SaveOptions options, CancellationToken cancellationToken)

Parâmetros

options SaveOptions

Opções de salvamento.

cancellationToken CancellationToken

Token de cancelamento.

Retorna

Task

Tarefa assíncrona.

SaveAsync(string, SaveFormat, CancellationToken)

Salva o documento com um novo nome junto com um formato de arquivo.

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

Parâmetros

outputFileName string

Caminho para o arquivo onde o documento será armazenado.

format SaveFormat

Opções de formato.

cancellationToken CancellationToken

Token de cancelamento.

Retorna

Task

Tarefa assíncrona.

SaveAsync(Stream, SaveFormat, CancellationToken)

Salva o documento com um novo nome junto com um formato de arquivo.

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

Parâmetros

outputStream Stream

Fluxo onde o documento será armazenado.

format SaveFormat

Opções de formato.

cancellationToken CancellationToken

Token de cancelamento.

Retorna

Task

Tarefa assíncrona.

Exceções

ArgumentException

System.ArgumentException quando Aspose.Pdf.HtmlSaveOptions é passado para um método. Salvar um documento no fluxo html não é suportado. Por favor, use o método salvar para o arquivo.

SaveAsync(string, SaveOptions, CancellationToken)

Salva o documento com um novo nome definindo suas opções de salvamento.

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

Parâmetros

outputFileName string

Caminho para o arquivo onde o documento será armazenado.

options SaveOptions

Opções de salvamento.

cancellationToken CancellationToken

Token de cancelamento.

Retorna

Task

Tarefa assíncrona.

SaveAsync(Stream, SaveOptions, CancellationToken)

Salva o documento em um fluxo com opções de salvamento.

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

Parâmetros

outputStream Stream

Fluxo onde o documento será armazenado.

options SaveOptions

Opções de salvamento.

cancellationToken CancellationToken

Token de cancelamento.

Retorna

Task

Tarefa assíncrona.

Exceções

ArgumentException

System.ArgumentException quando Aspose.Pdf.HtmlSaveOptions é passado para um método. Salvar um documento no fluxo html não é suportado. Por favor, use o método salvar para o arquivo.

SaveXml(string)

Salva o documento em XML.

public void SaveXml(string file)

Parâmetros

file string

O arquivo xml do modelo do documento.

SendTo(DocumentDevice, Stream)

Envia todo o documento para o dispositivo de documento para processamento.

public void SendTo(DocumentDevice device, Stream output)

Parâmetros

device DocumentDevice

Dispositivo de documento que é usado para processar o documento.

output Stream

Fluxo de saída que contém os resultados do processamento do documento com o dispositivo dado.

SendTo(DocumentDevice, int, int, Stream)

Envia as certas páginas do documento para o dispositivo de documento para processamento.

public void SendTo(DocumentDevice device, int fromPage, int toPage, Stream output)

Parâmetros

device DocumentDevice

Dispositivo de documento que é usado para processar o documento.

fromPage int

A primeira página para processamento.

toPage int

A última página para processamento.

output Stream

Fluxo de saída que contém os resultados do processamento das páginas do documento com o dispositivo dado.

SendTo(DocumentDevice, string)

Envia todo o documento para o dispositivo de documento para processamento.

public void SendTo(DocumentDevice device, string outputFileName)

Parâmetros

device DocumentDevice

Dispositivo de documento que é usado para processar o documento.

 Português