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 imagesDicas e melhores práticas
- Sempre ligue.
Close()ou utilização de:usingPara liberar recursos mantidos por objetos de fachada. - Utilização:
BindPdfcom um caminho de arquivo para grandes ficheiros, evitando carregar tudo na memória ao mesmo tempo. - Preferência
TryConcatenatee a)TryAppendsobre os seus homólogos não-Try por manipulação de erros graciosa. - Façadas delegadas ao núcleo
Documentmodelo internamente mudar para a API principal quando você precisa de controle fino. - A Comissão
FormEditorA facade permite adicionar novos campos de formulário a um PDF existente, não apenas preencher os existentes.
Problemas comuns
| Emissão | Causa da morte | Correção |
|---|---|---|
Save() produz arquivo vazio | BindPdf 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 escrito | Nome 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étodo | Descrição: |
|---|---|
Form | Fassada AcroForm para leitura e escrita de valores do campo |
Form.FillField | Indicar o valor de um campo do formulário por nome |
Form.GetField | Leia o valor de um campo do formulário pelo nome |
FormEditor | Adicionar ou modificar campos de formulário num PDF existente |
PdfFileEditor | Juntar, dividir, extrair e excluir faixas de página PDF |
PdfFileEditor.Concatenate | Combinar dois ou mais PDFs em um só |
PdfFileEditor.Extract | Extrair um intervalo de páginas para um novo PDF |
PdfContentEditor | Modificar o conteúdo da página (texto, anotações, ações) |
PdfFileSignature | Assinar e verificar as assinaturas digitais PDF |
PdfFileStamp | Estampas de texto ou imagens sobrepostas em páginas |
PdfConverter | Render páginas PDF para imagens raster |
FormattedText | Descrição de texto com estilo para operações de carimbo |
FontStyle | Enumeração dos estilos de fonte (enrolados, itálico etc.) |
EncodingType | Enumerar codificação de caracteres |