Como preencher e editar formulários PDF em C# | IronPDF

Como preencher e editar formulários PDF em C

This article was translated from English: Does it need improvement?
Translated
View the article in English

O IronPDF oferece um conjunto completo de ferramentas para edição de formulários PDF em aplicações C#. Preencha campos de texto, modifique caixas de seleção, atualize botões de opção e gerencie caixas de combinação programaticamente com chamadas de API simples que se integram perfeitamente aos seus projetos .NET .

Início rápido: Preenchendo e Editando Formulários PDF com o IronPDF

Preencha e edite formulários PDF com o IronPDF em apenas alguns passos. Este guia demonstra como localizar campos de formulário, modificar seus valores e salvar o documento atualizado. Ideal para integrar facilmente a edição de formulários PDF em seus aplicativos C#.

  1. Instale IronPDF com o Gerenciador de Pacotes NuGet

    PM > Install-Package IronPdf
  2. Copie e execute este trecho de código.

    var pdf = IronPdf.PdfDocument.FromFile("form.pdf");
    var field = pdf.Form.FindFormField("nameField");
    field.Value = "John Doe";
    pdf.SaveAs("updated_form.pdf");
  3. Implante para testar em seu ambiente de produção.

    Comece a usar IronPDF em seu projeto hoje com uma avaliação gratuita

    arrow pointer

Como editar PDF com formulários em C#?

O IronPDF edita sem esforço campos de formulário existentes de vários tipos em documentos PDF. Seja para automatizar fluxos de trabalho de documentos, criar envios de formulários em massa ou desenvolver aplicativos PDF interativos, os recursos de edição de formulários do IronPDF oferecem a flexibilidade e o controle necessários. A biblioteca suporta todos os tipos de campos de formulário PDF padrão e se integra perfeitamente com aplicativos .NET existentes, tornando-a ideal para sistemas de gerenciamento de documentos corporativos.

Para formulários complexos que exigem assinaturas digitais , o IronPDF oferece integração perfeita entre os fluxos de trabalho de edição de formulários e assinatura de documentos. Você também pode definir senhas e permissões para PDFs , protegendo seus formulários editados contra modificações não autorizadas.

Como preencho campos de texto e formulários de entrada?

Para editar áreas de texto e formulários de entrada, atribua a propriedade Valor à informação desejada. O código abaixo primeiro encontra o objeto do formulário usando o método FindFormField com o nome do formulário. Em seguida, ele acessa e atribui um valor à propriedade Value do objeto. Essa abordagem funciona de forma consistente em todos os campos de formulário baseados em texto, incluindo campos de entrada de linha única e áreas de texto com várias linhas.

Ao trabalhar com formulários que contêm metadados , você também pode atualizar programaticamente as propriedades do documento juntamente com os valores do formulário. Isso é particularmente útil para rastrear datas de envio de formulários ou manter um registro de auditoria das modificações de documentos.

:path=/static-assets/pdf/content-code-examples/how-to/edit-forms-input-textarea.cs
using IronPdf;

PdfDocument pdf = PdfDocument.FromFile("textAreaAndInputForm.pdf");

// Set text input form values
pdf.Form.FindFormField("firstname").Value = "John";
pdf.Form.FindFormField("lastname").Value = "Smith";

// Set text area form values
pdf.Form.FindFormField("address").Value = "Iron Software LLC\r\n205 N. Michigan Ave.";

pdf.SaveAs("textAreaAndInputFormEdited.pdf");
Imports Microsoft.VisualBasic
Imports IronPdf

Private pdf As PdfDocument = PdfDocument.FromFile("textAreaAndInputForm.pdf")

' Set text input form values
pdf.Form.FindFormField("firstname").Value = "John"
pdf.Form.FindFormField("lastname").Value = "Smith"

' Set text area form values
pdf.Form.FindFormField("address").Value = "Iron Software LLC" & vbCrLf & "205 N. Michigan Ave."

pdf.SaveAs("textAreaAndInputFormEdited.pdf")
$vbLabelText   $csharpLabel

Observe que, ao preencher áreas de texto com várias linhas, você pode usar \r\n para quebras de linha, a fim de formatar corretamente endereços, comentários ou qualquer outro conteúdo com várias linhas. Os campos do formulário ajustam automaticamente o texto com base nas dimensões definidas no PDF original.

Qual é a aparência do texto editado?


Como faço para atualizar caixas de seleção e caixas de combinação?

Edite formulários existentes com caixas de seleção e caixas de combinação, localizando primeiro o campo do formulário pelo seu nome. Atribua o valor 'Sim' à propriedade Value para marcar a caixa de seleção. Selecione qualquer opção disponível na caixa de combinação, atribuindo a opção desejada à sua propriedade Valor . Para sua conveniência, recupere todos os valores de escolha acessando a propriedade Choices .

Compreender como trabalhar com esses elementos de formulário interativos é crucial para a criação de aplicativos PDF dinâmicos. Se você precisa criar formulários PDF do zero, o IronPDF oferece ferramentas abrangentes para adicionar novas caixas de seleção, caixas de combinação e outros elementos de formulário aos seus documentos.

:path=/static-assets/pdf/content-code-examples/how-to/edit-forms-checkbox-combobox.cs
using IronPdf;
using System;

PdfDocument pdf = PdfDocument.FromFile("checkboxAndComboboxForm.pdf");

var checkboxForm = pdf.Form.FindFormField("taskCompleted");
// Check the checkbox form
checkboxForm.Value = "Yes";

var comboboxForm = pdf.Form.FindFormField("priority");
// Set the combobox value
comboboxForm.Value = "Low";

// Print out all the available choices
foreach (var choice in comboboxForm.Choices)
{
    Console.WriteLine(choice);
}
pdf.SaveAs("checkboxAndComboboxFormEdited.pdf");
Imports IronPdf
Imports System

Private pdf As PdfDocument = PdfDocument.FromFile("checkboxAndComboboxForm.pdf")

Private checkboxForm = pdf.Form.FindFormField("taskCompleted")
' Check the checkbox form
checkboxForm.Value = "Yes"

Dim comboboxForm = pdf.Form.FindFormField("priority")
' Set the combobox value
comboboxForm.Value = "Low"

' Print out all the available choices
For Each choice In comboboxForm.Choices
	Console.WriteLine(choice)
Next choice
pdf.SaveAs("checkboxAndComboboxFormEdited.pdf")
$vbLabelText   $csharpLabel

Os valores das caixas de seleção são normalmente "Sim" para selecionadas e "Não" para desmarcadas. Para caixas de combinação, sempre verifique se o valor que você está definindo existe entre as opções disponíveis para evitar erros de tempo de execução. A propriedade Choices oferece uma maneira conveniente de enumerar todas as opções válidas programaticamente.

Quais valores estão disponíveis para seleção na caixa de combinação?


Como faço para modificar os valores dos botões de opção?

Ao trabalhar com formulários de botões de opção no IronPDF, os botões de opção do mesmo grupo são contidos em um único objeto de formulário. Para editar o valor do botão de opção, basta atribuir a propriedade Value do objeto do formulário a uma das opções disponíveis. Recupere todas as opções disponíveis com a propriedade Anotações . O código abaixo demonstra como editar o valor do botão de opção.

Os botões de opção são particularmente úteis para opções mutuamente exclusivas em formulários. Ao combinar com anotações , você pode adicionar dicas úteis ou instruções para orientar os usuários no preenchimento do formulário. Isso melhora a experiência do usuário e reduz os erros no envio de formulários.

:path=/static-assets/pdf/content-code-examples/how-to/edit-forms-radiobutton.cs
using IronPdf;
using System;

PdfDocument pdf = PdfDocument.FromFile("radioButtomForm.pdf");
var radioForm = pdf.Form.FindFormField("traveltype");

// Set the radio button value
radioForm.Value = "Airplane";

// Print out all the available choices
foreach(var annotation in radioForm.Annotations)
{
    Console.WriteLine(annotation.OnAppearance);
}

pdf.SaveAs("radioButtomFormEdited.pdf");
Imports IronPdf
Imports System

Private pdf As PdfDocument = PdfDocument.FromFile("radioButtomForm.pdf")
Private radioForm = pdf.Form.FindFormField("traveltype")

' Set the radio button value
radioForm.Value = "Airplane"

' Print out all the available choices
For Each annotation In radioForm.Annotations
	Console.WriteLine(annotation.OnAppearance)
Next annotation

pdf.SaveAs("radioButtomFormEdited.pdf")
$vbLabelText   $csharpLabel

Além disso, use o método Clear para desmarcar o botão de opção. Este método só pode ser acessado quando o objeto for do tipo RadioFormField . Ao acessar o objeto do formulário de rádio no PDF, ele pode ser convertido para o tipo RadioFormField . Essa funcionalidade específica para cada tipo de formulário oferece maior controle sobre o comportamento dos botões de opção em comparação com a manipulação genérica de campos de formulário.

Como faço para limpar as seleções dos botões de opção?


Como faço para remover campos de formulário de PDFs?

Para remover formulários do PDF, primeiro selecione o formulário desejado usando o método FindFormField. Passe o objeto do formulário para o método Form.Remove, que pode ser acessado a partir do objeto PdfDocument . Essa funcionalidade é essencial quando você precisa criar versões estáticas de formulários preenchidos ou remover campos confidenciais de formulários antes da distribuição.

Após remover os campos do formulário, você pode querer salvar e exportar seus documentos PDF em vários formatos. O IronPDF oferece suporte a várias opções de exportação, incluindo salvar em disco, em fluxos de memória ou disponibilizar PDFs diretamente por meio de aplicativos da web.

:path=/static-assets/pdf/content-code-examples/how-to/edit-forms-remove-form.cs
using IronPdf;
using IronSoftware.Forms;

PdfDocument pdf = PdfDocument.FromFile("textAreaAndInputForm.pdf");

// Remove Form
IFormField targetForm = pdf.Form.FindFormField("firstname");
pdf.Form.Remove(targetForm);

pdf.SaveAs("removedForm.pdf");
Imports IronPdf
Imports IronSoftware.Forms

Private pdf As PdfDocument = PdfDocument.FromFile("textAreaAndInputForm.pdf")

' Remove Form
Private targetForm As IFormField = pdf.Form.FindFormField("firstname")
pdf.Form.Remove(targetForm)

pdf.SaveAs("removedForm.pdf")
$vbLabelText   $csharpLabel

A remoção dos campos do formulário os exclui permanentemente da estrutura do PDF. Se você precisar preservar os dados do formulário, mas tornar os campos não editáveis, considere usar o recurso de "achatar" o PDF, que converte os campos do formulário em conteúdo estático, preservando sua aparência visual e seus valores.

O que acontece depois de remover um campo de formulário?

Técnicas avançadas de edição de formulários

Além do preenchimento básico de formulários, o IronPDF permite cenários avançados, como o processamento em lote de vários formulários, a extração de dados de formulários para armazenamento em banco de dados e a criação de modelos de formulário dinâmicos. Para necessidades abrangentes de manipulação de PDFs, explore nosso tutorial completo sobre criação de PDFs, que abrange formulários, formatação e recursos avançados.

Ao trabalhar com dados confidenciais em formulários, considere sempre a implementação de medidas de segurança adequadas. Os recursos de segurança do IronPDF permitem criptografar documentos, definir permissões e garantir que os dados do formulário permaneçam protegidos durante todo o seu ciclo de vida.

Aprenda como criar formulários PDF programaticamente no seguinte artigo: " Como criar formulários PDF ".

Pronto para ver o que mais você pode fazer? Confira nossa página de tutoriais aqui: Assinar e proteger PDFs

Perguntas frequentes

Como preencher formulários PDF programaticamente em C#?

O IronPDF simplifica o preenchimento de formulários PDF em C#. Use o método `PdfDocument.FromFile` para carregar seu PDF e, em seguida, use `FindFormField` para localizar campos de formulário específicos pelo nome. Depois de encontrados, você pode modificar a propriedade `Value` do campo e salvar o documento atualizado. O IronPDF é compatível com todos os tipos de campos de formulário PDF padrão, incluindo campos de texto, caixas de seleção, botões de opção e caixas de combinação.

Que tipos de campos de formulário PDF podem ser editados?

O IronPDF suporta a edição de todos os tipos de campos de formulário PDF padrão, incluindo áreas de texto, campos de entrada, caixas de seleção, botões de opção e caixas de combinação. A biblioteca fornece uma API consistente para modificar cada tipo de campo por meio de atribuições de propriedades simples, facilitando a automação do preenchimento de formulários em diferentes tipos de campos.

Como faço para encontrar e modificar um campo específico de um formulário?

Utilize o método FindFormField do IronPDF com o nome do campo como parâmetro para localizar qualquer campo de formulário em seu documento PDF. Uma vez encontrado, você pode modificar o campo definindo sua propriedade Value. Por exemplo: var field = pdf.Form.FindFormField("nameField"); field.Value = "John Doe";

Posso proteger formulários PDF editados contra alterações não autorizadas?

Sim, o IronPDF permite definir senhas e permissões para PDFs após a edição de formulários. Isso garante a segurança dos formulários preenchidos e impede modificações não autorizadas. A biblioteca também oferece suporte a assinaturas digitais para autenticação e integridade adicionais dos documentos.

É possível editar formulários PDF em lote?

O IronPDF é ideal para processamento e automação de formulários em massa. Você pode iterar programaticamente por vários arquivos PDF, preencher seus formulários com dados de bancos de dados ou outras fontes e salvar os documentos concluídos. Isso torna o IronPDF perfeito para sistemas de gerenciamento de documentos corporativos e aplicativos de fluxo de trabalho automatizados.

Posso atualizar os metadados do documento enquanto edito formulários?

Sim, o IronPDF permite atualizar os metadados do PDF juntamente com os valores do formulário. Isso é particularmente útil para rastrear datas de envio de formulários, manter registros de auditoria ou adicionar propriedades personalizadas aos seus documentos editados para melhor organização e facilidade de busca.

Curtis Chau
Redator Técnico

Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais ...

Leia mais
Pronto para começar?
Nuget Downloads 18,318,263 | Versão: 2026.4 acaba de ser lançado
Still Scrolling Icon

Ainda está rolando a tela?

Quer provas rápidas? PM > Install-Package IronPdf
executar um exemplo Veja seu HTML se transformar em um PDF.