1. IronPDF
  2. Tutoriais
  3. Criar formulários em PDF
Como criar formulários PDF em C# usando IronPDF

Como criar formulários PDF em C

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

Crie formulários PDF interativos em C# usando a API abrangente do IronPDF, que oferece suporte a entradas de texto, caixas de seleção, botões de opção, caixas de combinação, formulários de imagem e assinaturas digitais com apenas algumas linhas de código.

Início rápido: Crie seu primeiro formulário PDF com o IronPDF

Comece rapidamente a usar o IronPDF para criar formulários PDF interativos e preenchíveis. Este guia mostra como gerar dinamicamente um PDF com campos de formulário usando um código C# simples. Aproveitando a robusta API do IronPDF, você pode criar campos de texto, caixas de seleção e muito mais para aprimorar a interação do usuário com o mínimo de esforço. Acompanhe para ver como é fácil definir elementos de formulário e salvar seu documento.

  1. Instale IronPDF com o Gerenciador de Pacotes NuGet

    PM > Install-Package IronPdf

  2. Copie e execute este trecho de código.

    new IronPdf.ChromePdfRenderer { RenderingOptions = { CreatePdfFormsFromHtml = true } }
    .RenderHtmlAsPdf("<html><body><form>First name: <input type='text' name='firstname' value=''>Last name: <input type='text' name='lastname' value=''></form></body></html>")
    .SaveAs("editableForm.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

Fluxo de trabalho mínimo (5 etapas)

  1. Baixe a biblioteca IronPDF C#
  2. Utilize as tags input e textarea em HTML para gerar formulários.
  3. Defina o tipo como "checkbox" e use a tag select para caixas de seleção e caixas de combinação.
  4. Altere o tipo para "radio" para os botões de opção.
  5. Verifique o PDF gerado.

Como criar formulários em PDF com o IronPDF?

O IronPDF cria documentos PDF com campos de formulário incorporados de vários tipos. Ao adicionar elementos de formulário dinâmicos a documentos PDF estáticos, você aumenta a flexibilidade e a interatividade. A biblioteca oferece suporte a todos os elementos de formulário necessários para aplicativos PDF modernos, desde entradas de texto simples até campos de assinatura complexos. Antes de criar formulários, certifique-se de ter instalado o IronPDF e configurado seu ambiente de desenvolvimento.

Como posso adicionar áreas de texto e formulários de entrada?

Como faço para renderizar formulários a partir de HTML?

Crie áreas de texto e formulários de entrada para capturar a entrada do usuário em documentos PDF. As áreas de texto oferecem espaço para textos mais extensos, enquanto os formulários de entrada permitem a inserção de valores específicos. O mecanismo de conversão de HTML para PDF do IronPDF oferece suporte a elementos de formulário HTML, simplificando a criação de formulários complexos.

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

// Input and Text Area forms HTML
string FormHtml = @"
<html>
    <body>
        <h2>Editable PDF Form</h2>
        <form>
            First name: <br> <input type='text' name='firstname' value=''> <br>
            Last name: <br> <input type='text' name='lastname' value=''> <br>
            Address: <br> <textarea name='address' rows='4' cols='50'></textarea>
        </form>
    </body>
</html>
";

// Instantiate Renderer
ChromePdfRenderer Renderer = new ChromePdfRenderer();
Renderer.RenderingOptions.CreatePdfFormsFromHtml = true;

Renderer.RenderHtmlAsPdf(FormHtml).SaveAs("textAreaAndInputForm.pdf");
Imports IronPdf

' Input and Text Area forms HTML
Private FormHtml As String = "
<html>
    <body>
        <h2>Editable PDF Form</h2>
        <form>
            First name: <br> <input type='text' name='firstname' value=''> <br>
            Last name: <br> <input type='text' name='lastname' value=''> <br>
            Address: <br> <textarea name='address' rows='4' cols='50'></textarea>
        </form>
    </body>
</html>
"

' Instantiate Renderer
Private Renderer As New ChromePdfRenderer()
Renderer.RenderingOptions.CreatePdfFormsFromHtml = True

Renderer.RenderHtmlAsPdf(FormHtml).SaveAs("textAreaAndInputForm.pdf")
$vbLabelText   $csharpLabel

Documento PDF de saída

Como faço para adicionar formulários de texto programaticamente?

Adicione campos de formulário de texto por meio de código, sem usar HTML. Primeiro, instancie um objeto TextFormField com os parâmetros necessários. Em seguida, use o método Add da propriedade Form para adicionar o formulário. Essa abordagem funciona bem quando você precisa editar PDFs existentes ou adicionar formulários a documentos que não foram criados em HTML.

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

// Instantiate ChromePdfRenderer
ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h2>Editable PDF Form</h2>");

// Configure required parameters
string name = "firstname";
string value = "first name";
uint pageIndex = 0;
double x = 100;
double y = 700;
double width = 50;
double height = 15;

// Create text form field
var textForm = new TextFormField(name, value, pageIndex, x, y, width, height);

// Add form
pdf.Form.Add(textForm);

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

' Instantiate ChromePdfRenderer
Private renderer As New ChromePdfRenderer()

Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h2>Editable PDF Form</h2>")

' Configure required parameters
Private name As String = "firstname"
Private value As String = "first name"
Private pageIndex As UInteger = 0
Private x As Double = 100
Private y As Double = 700
Private width As Double = 50
Private height As Double = 15

' Create text form field
Private textForm = New TextFormField(name, value, pageIndex, x, y, width, height)

' Add form
pdf.Form.Add(textForm)

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

Documento PDF de saída

Adicione rótulos aos campos do formulário usando o método DrawText. Saiba mais sobre como desenhar texto e bitmaps em PDFs . Explore fontes personalizadas para aprimorar a aparência do formulário.

Como faço para criar formulários com caixas de seleção e caixas de combinação?

Como faço para renderizar caixas de seleção e caixas de combinação a partir do HTML?

Crie formulários com caixas de seleção e caixas de combinação renderizando strings HTML, arquivos ou URLs da web que contenham esses elementos. Defina a propriedade CreatePdfFormsFromHtml como verdadeira para habilitar a criação de formulários. Para cenários complexos, converta páginas ASPX que contenham controles de formulário do lado do servidor.

Os formulários de caixa de combinação oferecem opções de seleção suspensa. Os usuários escolhem entre as opções disponíveis, fornecendo informações em documentos PDF.

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

// Input and Text Area forms HTML
string FormHtml = @"
<html>
    <body>
        <h2>Editable PDF Form</h2>
        <h2>Task Completed</h2>
        <label>
            <input type='checkbox' id='taskCompleted' name='taskCompleted'> Mark task as completed
        </label>

        <h2>Select Priority</h2>
        <label for='priority'>Choose priority level:</label>
        <select id='priority' name='priority'>
            <option value='high'>High</option>
            <option value='medium'>Medium</option>
            <option value='low'>Low</option>
        </select>
    </body>
</html>
";

// Instantiate Renderer
ChromePdfRenderer Renderer = new ChromePdfRenderer();
Renderer.RenderingOptions.CreatePdfFormsFromHtml = true;

Renderer.RenderHtmlAsPdf(FormHtml).SaveAs("checkboxAndComboboxForm.pdf");
Imports IronPdf

' Input and Text Area forms HTML
Private FormHtml As String = "
<html>
    <body>
        <h2>Editable PDF Form</h2>
        <h2>Task Completed</h2>
        <label>
            <input type='checkbox' id='taskCompleted' name='taskCompleted'> Mark task as completed
        </label>

        <h2>Select Priority</h2>
        <label for='priority'>Choose priority level:</label>
        <select id='priority' name='priority'>
            <option value='high'>High</option>
            <option value='medium'>Medium</option>
            <option value='low'>Low</option>
        </select>
    </body>
</html>
"

' Instantiate Renderer
Private Renderer As New ChromePdfRenderer()
Renderer.RenderingOptions.CreatePdfFormsFromHtml = True

Renderer.RenderHtmlAsPdf(FormHtml).SaveAs("checkboxAndComboboxForm.pdf")
$vbLabelText   $csharpLabel

Documento PDF de saída

Como adicionar caixas de seleção e caixas de combinação programaticamente?

Como faço para criar um campo de formulário do tipo caixa de seleção?

Para adicionar caixas de seleção, instancie um objeto CheckboxFormField com os parâmetros necessários. O parâmetro value determina o estado da seleção: "no" para desmarcado e "yes" para marcado. Use o método Add da propriedade Form para adicionar o formulário.

:path=/static-assets/pdf/content-code-examples/how-to/create-forms-add-checkbox.cs
using IronPdf;
using IronSoftware.Forms;

// Instantiate ChromePdfRenderer
ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h2>Checkbox Form Field</h2>");

// Configure required parameters
string name = "checkbox";
string value = "no";
uint pageIndex = 0;
double x = 100;
double y = 700;
double width = 15;
double height = 15;

// Create checkbox form field
var checkboxForm = new CheckboxFormField(name, value, pageIndex, x, y, width, height);

// Add form
pdf.Form.Add(checkboxForm);

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

' Instantiate ChromePdfRenderer
Private renderer As New ChromePdfRenderer()

Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h2>Checkbox Form Field</h2>")

' Configure required parameters
Private name As String = "checkbox"
Private value As String = "no"
Private pageIndex As UInteger = 0
Private x As Double = 100
Private y As Double = 700
Private width As Double = 15
Private height As Double = 15

' Create checkbox form field
Private checkboxForm = New CheckboxFormField(name, value, pageIndex, x, y, width, height)

' Add form
pdf.Form.Add(checkboxForm)

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

Documento PDF de saída

Como faço para criar um campo de formulário do tipo caixa de combinação?

Para adicionar caixas de combinação, instancie um objeto ComboboxFormField com os parâmetros necessários. O parâmetro value determina a opção selecionada. Use o método Add da propriedade Form para adicionar o formulário. Ao trabalhar com dados de formulários, extraia texto e imagens de PDFs existentes para preencher caixas de combinação dinamicamente.

:path=/static-assets/pdf/content-code-examples/how-to/create-forms-add-combobox.cs
using IronPdf;
using IronSoftware.Forms;
using System.Collections.Generic;

// Instantiate ChromePdfRenderer
ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h2>Combobox Form Field</h2>");

// Configure required parameters
string name = "combobox";
string value = "Car";
uint pageIndex = 0;
double x = 100;
double y = 700;
double width = 60;
double height = 15;
var choices = new List<string>() { "Car", "Bike", "Airplane" };

// Create combobox form field
var comboboxForm = new ComboboxFormField(name, value, pageIndex, x, y, width, height, choices);

// Add form
pdf.Form.Add(comboboxForm);

pdf.SaveAs("addComboboxForm.pdf");
Imports IronPdf
Imports IronSoftware.Forms
Imports System.Collections.Generic

' Instantiate ChromePdfRenderer
Private renderer As New ChromePdfRenderer()

Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h2>Combobox Form Field</h2>")

' Configure required parameters
Private name As String = "combobox"
Private value As String = "Car"
Private pageIndex As UInteger = 0
Private x As Double = 100
Private y As Double = 700
Private width As Double = 60
Private height As Double = 15
Private choices = New List(Of String)() From {"Car", "Bike", "Airplane"}

' Create combobox form field
Private comboboxForm = New ComboboxFormField(name, value, pageIndex, x, y, width, height, choices)

' Add form
pdf.Form.Add(comboboxForm)

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

Documento PDF de saída

Como faço para criar formulários com botões de opção?

Como faço para renderizar botões de opção a partir do HTML?

Os botões de opção do mesmo grupo estão contidos em um único objeto de formulário. Recupere o formulário usando o método FindFormField com seu nome. A propriedade Valor contém o valor da opção selecionada ou 'Nenhum' se não estiver selecionada. Isso espelha o comportamento dos botões de opção em HTML.

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

// Radio buttons HTML
string FormHtml = @"
<html>
    <body>
        <h2>Editable PDF Form</h2>
        Choose your preferred travel type: <br>
        <input type='radio' name='traveltype' value='Bike'>
        Bike <br>
        <input type='radio' name='traveltype' value='Car'>
        Car <br>
        <input type='radio' name='traveltype' value='Airplane'>
        Airplane
    </body>
</html>
";

// Instantiate Renderer
ChromePdfRenderer Renderer = new ChromePdfRenderer();
Renderer.RenderingOptions.CreatePdfFormsFromHtml = true;

Renderer.RenderHtmlAsPdf(FormHtml).SaveAs("radioButtomForm.pdf");
Imports IronPdf

' Radio buttons HTML
Private FormHtml As String = "
<html>
    <body>
        <h2>Editable PDF Form</h2>
        Choose your preferred travel type: <br>
        <input type='radio' name='traveltype' value='Bike'>
        Bike <br>
        <input type='radio' name='traveltype' value='Car'>
        Car <br>
        <input type='radio' name='traveltype' value='Airplane'>
        Airplane
    </body>
</html>
"

' Instantiate Renderer
Private Renderer As New ChromePdfRenderer()
Renderer.RenderingOptions.CreatePdfFormsFromHtml = True

Renderer.RenderHtmlAsPdf(FormHtml).SaveAs("radioButtomForm.pdf")
$vbLabelText   $csharpLabel

Documento PDF de saída

Como adiciono formulários de rádio programaticamente?

Adicione campos de formulário com botões de opção por meio de código. Instancie um objeto RadioFormField com os parâmetros necessários. Use o método Add da propriedade Form para adicionar o formulário. Essa abordagem é útil ao mesclar PDFs e adicionar campos de formulário consistentes em diferentes documentos.

:path=/static-assets/pdf/content-code-examples/how-to/create-forms-add-radiobutton.cs
using IronPdf;
using IronSoftware.Forms;

// Instantiate ChromePdfRenderer
ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h2>Editable PDF Form</h2>");

// Configure required parameters
string name = "choice";
string value = "yes";
uint pageIndex = 0;
double x = 100;
double y = 700;
double width = 15;
double height = 15;

// Create the first radio form
var yesRadioform = new RadioFormField(name, value, pageIndex, x, y, width, height);

value = "no";
x = 200;

// Create the second radio form
var noRadioform = new RadioFormField(name, value, pageIndex, x, y, width, height);

pdf.Form.Add(yesRadioform);
pdf.Form.Add(noRadioform);

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

' Instantiate ChromePdfRenderer
Private renderer As New ChromePdfRenderer()

Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h2>Editable PDF Form</h2>")

' Configure required parameters
Private name As String = "choice"
Private value As String = "yes"
Private pageIndex As UInteger = 0
Private x As Double = 100
Private y As Double = 700
Private width As Double = 15
Private height As Double = 15

' Create the first radio form
Private yesRadioform = New RadioFormField(name, value, pageIndex, x, y, width, height)

value = "no"
x = 200

' Create the second radio form
Dim noRadioform = New RadioFormField(name, value, pageIndex, x, y, width, height)

pdf.Form.Add(yesRadioform)
pdf.Form.Add(noRadioform)

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

Documento PDF de saída

Use o método DrawText para adicionar rótulos aos botões de opção. Saiba mais sobre como desenhar texto e bitmaps em PDFs .

Como adiciono formulários de imagem a PDFs?

Adicione campos de formulário com imagens somente por meio de código. Instancie um objeto ImageFormField com os parâmetros necessários. Use o método Add da propriedade Form para adicionar o formulário. Formulários com imagens funcionam bem para identificação por foto ou captura de assinaturas.

:path=/static-assets/pdf/content-code-examples/how-to/create-forms-add-image.cs
using IronPdf;
using IronSoftware.Forms;

// Instantiate ChromePdfRenderer
ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h2>Editable PDF Form</h2>");

// Configure required parameters
string name = "image1";
uint pageIndex = 0;
double x = 100;
double y = 600;
double width = 200;
double height = 200;

// Create the image form
ImageFormField imageForm = new ImageFormField(name, pageIndex, x, y, width, height);

pdf.Form.Add(imageForm);

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

' Instantiate ChromePdfRenderer
Private renderer As New ChromePdfRenderer()

Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h2>Editable PDF Form</h2>")

' Configure required parameters
Private name As String = "image1"
Private pageIndex As UInteger = 0
Private x As Double = 100
Private y As Double = 600
Private width As Double = 200
Private height As Double = 200

' Create the image form
Private imageForm As New ImageFormField(name, pageIndex, x, y, width, height)

pdf.Form.Add(imageForm)

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

Documento PDF de saída

Arquivo PDF de saída: Visualizar PDF da imagem . Os navegadores não suportam formulários de imagem; Abra no Adobe Acrobat para testar esse recurso.

Editor de formulário PDF exibindo a caixa de diálogo Selecionar Imagem com navegador de arquivos, área de visualização e botões OK/Cancelar.

Como faço para criar formulários de assinatura não assinada?

Insira um campo de assinatura não assinado ou vazio criando um objeto de assinatura. Acesse a propriedade Form do PDF de destino e use o método Add para inserir a assinatura. Exporte o PDF com o campo de assinatura vazio. Isso possibilita assinaturas digitais que podem ser preenchidas posteriormente com dados de assinatura reais.

:path=/static-assets/pdf/content-code-examples/how-to/signing-unsigned-signature.cs
using IronPdf;
using IronSoftware.Forms;

ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>testing</h1>");

// Configure required parameters
string name = "cert";
uint pageIndex = 0;
double x = 100;
double y = 600;
double width = 300;
double height = 100;

// Create signature
SignatureFormField signature = new SignatureFormField(name, pageIndex, x, y, width, height);

// Add signature
pdf.Form.Add(signature);

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

Private renderer As New ChromePdfRenderer()
Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>testing</h1>")

' Configure required parameters
Private name As String = "cert"
Private pageIndex As UInteger = 0
Private x As Double = 100
Private y As Double = 600
Private width As Double = 300
Private height As Double = 100

' Create signature
Private signature As New SignatureFormField(name, pageIndex, x, y, width, height)

' Add signature
pdf.Form.Add(signature)

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

Documento PDF de saída

Arquivo PDF de saída: signature.pdf . Os navegadores não suportam formulários de assinatura; Abra no Adobe Acrobat para testar esse recurso. Para maior segurança, considere assinar PDFs com HSM .

O Adobe Acrobat exibe um campo de assinatura não assinada em um documento PDF com a barra lateral de ferramentas de edição.

Aprenda a preencher e editar formulários PDF programaticamente: " Como preencher e editar formulários PDF ". Para obter informações completas sobre segurança de formulários, consulte nosso guia sobre permissões e senhas de PDF .

Pronto para explorar mais? Confira nosso tutorial: Assinar e proteger PDFs

Perguntas frequentes

Como faço para criar formulários PDF preenchíveis em C#?

Você pode criar formulários PDF preenchíveis em C# usando a API abrangente do IronPDF. Basta usar o ChromePdfRenderer com a opção CreatePdfFormsFromHtml definida como true e, em seguida, renderizar o HTML contendo elementos de formulário, como campos de entrada, áreas de texto, caixas de seleção e botões de opção. O IronPDF converterá automaticamente esses elementos de formulário HTML em campos de formulário PDF interativos.

Que tipos de campos de formulário posso adicionar aos PDFs?

O IronPDF permite adicionar vários tipos de campos de formulário, incluindo entradas de texto, áreas de texto, caixas de seleção, botões de opção, caixas de combinação, formulários de imagem e assinaturas digitais. Você pode criá-los renderizando formulários HTML ou adicionando campos de formulário programaticamente usando a API do IronPDF.

Posso criar formulários em PDF sem usar HTML?

Sim, o IronPDF permite adicionar campos de formulário programaticamente, sem HTML. Você pode instanciar objetos de campo de formulário, como TextFormField, com os parâmetros necessários e usar o método Add da propriedade Form para adicioná-los diretamente ao seu documento PDF. Essa abordagem é ideal para editar PDFs existentes ou criar formulários dinamicamente.

Como faço para habilitar a criação de formulários ao converter HTML para PDF?

Para habilitar a criação de formulários durante a conversão de HTML para PDF com o IronPDF, defina a propriedade `CreatePdfFormsFromHtml` como `true` nas opções de renderização do `ChromePdfRenderer`. Isso instrui o IronPDF a converter os elementos do formulário HTML em campos de formulário PDF interativos durante o processo de renderização.

Qual é a maneira mais rápida de criar um formulário PDF simples?

A maneira mais rápida de criar um formulário PDF com o IronPDF é usando uma única linha de código: `new ChromePdfRenderer` com `CreatePdfFormsFromHtml` definido como `true`, em seguida, chame `RenderHtmlAsPdf` com o conteúdo HTML do seu formulário e salve o resultado. Isso converte automaticamente os elementos de entrada HTML em campos de formulário PDF preenchíveis.

Curtis Chau
Curtis Chau
  Converse agora mesmo com a equipe de engenharia.
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.