API de Fachadas

Fachadas API

A API Facades fornece wrappers simplificados e orientados a tarefas ao redor do núcleo
Aspose.PDF FOSS for .NET modelo de objeto.
Cada classe facade tem como alvo uma
operação PDF — preenchimento de formulário, concatenação de arquivos, edição de conteúdo ou digital
assinatura — e expõe um BindPdf / Save fluxo de trabalho.

Preenchimento de formulário com a fachada Form

Form (em Aspose.Pdf.Facades) vincula‑se a um PDF existente e permite ler ou gravar valores de campos AcroForm sem navegar na árvore de páginas.

using var form = new Form("input.pdf", "output.pdf");
form.FillField("FirstName", "Alice");
form.FillField("AcceptTerms", "Yes");
form.Save();

Para ler valores de campo:

using var form = new Form("input.pdf");
string name = form.GetField("FirstName");

Mesclando e dividindo PDFs com PdfFileEditor

PdfFileEditor concatena, divide, extrai e exclui intervalos de páginas.

var editor = new PdfFileEditor();

// Concatenate two files
editor.Concatenate("file1.pdf", "file2.pdf", "merged.pdf");

// Extract pages 2-5
editor.Extract("source.pdf", 2, 5, "pages2to5.pdf");

// Split at page 3
editor.SplitFromFirst("source.pdf", 3, "first3.pdf");

Editando conteúdo da página com PdfContentEditor

PdfContentEditor modifica o conteúdo da página existente — adiciona texto, substitui texto ou anexa ações às anotações.

var editor = new PdfContentEditor();
editor.BindPdf("input.pdf");
// Perform content edits
editor.Save("output.pdf");

Assinaturas digitais com PdfFileSignature

PdfFileSignature assina documentos PDF e verifica assinaturas existentes.

var sig = new PdfFileSignature();
sig.BindPdf("document.pdf");
// Sign or verify
sig.Save("signed.pdf");

Carimbagem de página com PdfFileStamp

PdfFileStamp sobrepõe texto, imagens ou outras páginas PDF como carimbos.

var stamp = new PdfFileStamp();
stamp.BindPdf("input.pdf");
// Add stamps
stamp.Save("stamped.pdf");
stamp.Close();

Convertendo páginas em imagens com PdfConverter

PdfConverter renderiza páginas PDF para formatos de imagem raster.

var converter = new PdfConverter();
converter.BindPdf("input.pdf");
converter.DoConvert();
// Iterate pages and save images

Dicas e Melhores Práticas

• Sempre chame Close() ou use using para liberar os recursos mantidos pelos objetos facade.
• Use BindPdf com um caminho de arquivo para arquivos grandes, a fim de evitar carregar tudo na memória de uma só vez.
• Prefira TryConcatenate e TryAppend em vez de suas versões sem Try para um tratamento de erros mais elegante.
• As facades delegam internamente ao modelo central Document — troque para a API central quando precisar de controle mais granular.
• A fachada FormEditor permite adicionar novos campos de formulário a um PDF existente, não apenas preencher os já existentes.

Problemas Comuns

Perguntas Frequentes

Qual é a diferença entre Facades e a core Document API?

Facades fornecem métodos de alto nível, orientados por tarefas (preencher um formulário, mesclar arquivos).
A API principal (Document, Page, Annotation) oferece acesso de nível inferior a todos os objetos PDF. Facades usam a API principal internamente.

Posso encadear várias operações de fachada?

Sim. Vincule a mesma fonte, execute as operações e salve uma única vez. Ou salve um
resultado intermediário e recoloque a vinculação para a próxima operação.

O PdfFileEditor suporta PDFs protegidos por senha?

Sim. Sobrecargas que aceitam senhas de proprietário/usuário estão disponíveis para arquivos criptografados.

Resumo da Referência da API

Veja Também

• Aspose.PDF for .NET Produto Enterprise