API de fachadas

API de fachadas

A API Facades fornece envoltórios simplificados e orientados para tarefas em torno do núcleo. Aspose.PDF FOSS for .NET object model. Each facade class targets a specific Operação PDF preenchimento de formulários, concatenação de ficheiros, edição do conteúdo ou digitalização A assinatura e expõe um BindPdf / Save fluxo de trabalho.


Preenchimento do formulário com a fachada do formulario

Form (em Aspose.Pdf.Facades) liga-se a um PDF existente e permite que você leia o texto. ou escrever valores de campo AcroForm sem navegar na árvore da página.

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

Para ler os valores dos campos:

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

Fusão e divisão de PDFs com o PdfFileEditor

PdfFileEditor concatenates, divides, extrações e exclusões 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");

Editar conteúdo de página com o PdfContentEditor

PdfContentEditor modifica o conteúdo da página existente adicionar texto, substituir texto;, ou anexar 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 Assinatura de documentos PDF e verificação das assinaturas existentes.

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

Estampagem de página com PdfFileStamp

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

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

Converter páginas em imagens com o PdfConverter

PdfConverter Transforma páginas PDF em 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 ligue. Close() ou utilização de: using Para liberar recursos mantidos por objetos de fachada.
  • Utilização: BindPdf com um caminho de arquivo para grandes ficheiros, evitando carregar tudo na memória ao mesmo tempo.
  • Preferência TryConcatenate e a) TryAppend sobre os seus homólogos não-Try por manipulação de erros graciosa.
  • Façadas delegadas ao núcleo Document modelo internamente mudar para a API principal quando você precisa de controle fino.
  • A Comissão FormEditor A facade permite adicionar novos campos de formulário a um PDF existente, não apenas preencher os existentes.

Problemas comuns

EmissãoCausa da morteCorreção
Save() produz arquivo vazioBindPdf Não foi chamado antes de salvar.Sempre ligar um PDF de origem antes de chamar Save
Valor do campo de formulário não escritoNome do campo não corresponde ao nome de campo interno do PDF.Utilização: Form.FieldNames para listar os nomes de campo disponíveis
A concatenation falha silenciosamente.O ficheiro de entrada está criptografado ou corrompido .Utilização: TryConcatenate e verificar o valor de retorno
As assinaturas não são válidas após a edição .O conteúdo foi alterado após a assinatura.Assine o documento como a última etapa .

FAQ

Qual é a diferença entre as Facades e o núcleo da API Document?

As fachadas fornecem métodos de alto nível, orientados para tarefas (preencher um formulário, juntar arquivos). A API central (Document, Page, Annotation) dá acesso a nível inferior à informação sobre o ambiente. As fachadas usam a API central internamente.

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

Sim, liga a mesma fonte e realiza operações para salvar uma vez ou guarda um resultado intermediário e religa para a próxima operação.

O PdfFileEditor suporta PDFs protegidos por senha?

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


Resumo de referência da API

Classe / MétodoDescrição:
FormFassada AcroForm para leitura e escrita de valores do campo
Form.FillFieldIndicar o valor de um campo do formulário por nome
Form.GetFieldLeia o valor de um campo do formulário pelo nome
FormEditorAdicionar ou modificar campos de formulário num PDF existente
PdfFileEditorJuntar, dividir, extrair e excluir faixas de página PDF
PdfFileEditor.ConcatenateCombinar dois ou mais PDFs em um só
PdfFileEditor.ExtractExtrair um intervalo de páginas para um novo PDF
PdfContentEditorModificar o conteúdo da página (texto, anotações, ações)
PdfFileSignatureAssinar e verificar as assinaturas digitais PDF
PdfFileStampEstampas de texto ou imagens sobrepostas em páginas
PdfConverterRender páginas PDF para imagens raster
FormattedTextDescrição de texto com estilo para operações de carimbo
FontStyleEnumeração dos estilos de fonte (enrolados, itálico etc.)
EncodingTypeEnumerar codificação de caracteres

Ver também:

 Português