1. IronPDF
  2. Tutoriais
  3. Substituir texto em PDF
Como substituir texto em um PDF | IronPDF

Como substituir texto em um PDF usando C

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

Substitua texto em PDFs usando C# com a API simples do IronPDF - use ReplaceTextOnAllPages() para alterações em todo o documento ou ReplaceTextOnPage() para páginas específicas. Isso possibilita correções automatizadas, personalização de modelos e atualizações dinâmicas de conteúdo em aplicativos .NET .

Início rápido: Substitua o texto em PDF com o IronPDF

Comece a substituir texto em seus PDFs sem esforço usando o IronPDF. Com apenas algumas linhas de código, você pode atualizar ou personalizar documentos rapidamente. Este exemplo demonstra como substituir o texto em todas as páginas de um PDF. Basta carregar o seu PDF, especificar o texto a ser localizado e substituído e salvar o documento atualizado. Ideal para corrigir erros de digitação ou atualizar informações em modelos, o IronPDF torna a substituição de texto em C# perfeita. Explore este guia para transformar a eficiência do seu gerenciamento de PDFs em ambientes .NET .

  1. Instale IronPDF com o Gerenciador de Pacotes NuGet

    PM > Install-Package IronPdf

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

    IronPdf.PdfDocument.FromFile("example.pdf")
    .ReplaceTextOnAllPages("old text", "new text")
    .SaveAs("updated.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. Gere um novo PDF ou importe um documento PDF existente.
  3. Utilize o método `ReplaceTextOnAllPages` para substituir o texto em todo o documento.
  4. Especifique os números de página para a substituição de texto desejada.
  5. Exporte o documento PDF editado.


Como faço para substituir texto em um PDF?

A ação 'substituir texto' pode ser aplicada a qualquer objeto PdfDocument, seja ele recém-renderizado ou importado. Utilize o método ReplaceTextOnAllPages fornecendo o texto antigo e o novo para substituição. Se o método não conseguir localizar o texto antigo especificado, ele lançará uma exceção com a mensagem 'Erro ao substituir o texto: falha ao encontrar o texto '.NET6'.'

No exemplo de código abaixo, demonstramos como substituir o texto em um documento PDF recém-renderizado que contém o texto '.NET6'. Essa funcionalidade é particularmente útil ao trabalhar com a conversão de HTML para PDF ou quando você precisa editar PDF de forma programática.

Qual é a aparência do código básico?

:path=/static-assets/pdf/content-code-examples/how-to/find-replace-text-all-page.cs
using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>.NET6</h1>");

string oldText = ".NET6";
string newText = ".NET7";

// Replace text on all pages
pdf.ReplaceTextOnAllPages(oldText, newText);

pdf.SaveAs("replaceText.pdf");
Imports IronPdf

Private renderer As New ChromePdfRenderer()

Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>.NET6</h1>")

Private oldText As String = ".NET6"
Private newText As String = ".NET7"

' Replace text on all pages
pdf.ReplaceTextOnAllPages(oldText, newText)

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

Ao implementar a substituição de texto em seus aplicativos, você também pode explorar a possibilidade de adicionar cabeçalhos e rodapés ou aplicar marcas d'água personalizadas aos seus PDFs para aprimorar a identidade visual e a identificação do documento.

Como faço para substituir texto por novas linhas?

A ação de substituir texto suporta caracteres de nova linha, permitindo substituir o texto antigo por uma nova sequência que inclui quebras de linha integradas para melhor formatação e clareza visual. Essa funcionalidade é essencial quando você precisa manter a estrutura adequada do documento ou quando trabalha com conteúdo de texto em várias linhas . Para conseguir isso, adicione caracteres de nova linha (\n) à nova string. Usando o exemplo acima, substitua newText por .NET7\nnewline em vez de apenas .NET7. Essa abordagem funciona perfeitamente com as diversas opções de renderização disponíveis no IronPDF.

Como faço para substituir o texto em páginas específicas?

Para maior precisão na substituição de texto em um documento, o IronPDF oferece opções para substituir texto em uma única página ou em várias páginas. Use o método ReplaceTextOnPage para substituir o texto em uma página específica e o método ReplaceTextOnPages para substituir o texto em várias páginas especificadas. Esse controle granular é particularmente útil ao trabalhar com formulários ou documentos PDF complexos com conteúdo variável entre as páginas.

PontasTodos os índices de página seguem a indexação baseada em zero.

Como faço para substituir o texto em uma única página?

:path=/static-assets/pdf/content-code-examples/how-to/find-replace-text-on-single-page.cs
using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>.NET6</h1>");

string oldText = ".NET6";
string newText = ".NET7";

// Replace text on page 1
pdf.ReplaceTextOnPage(0, oldText, newText);

pdf.SaveAs("replaceTextOnSinglePage.pdf");
Imports IronPdf

Private renderer As New ChromePdfRenderer()

Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>.NET6</h1>")

Private oldText As String = ".NET6"
Private newText As String = ".NET7"

' Replace text on page 1
pdf.ReplaceTextOnPage(0, oldText, newText)

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

Essa funcionalidade de substituição de página única integra-se bem com outras operações específicas de página, como adicionar números de página ou quando você precisa dividir PDFs para modificar o conteúdo de forma direcionada.

Como faço para substituir texto em várias páginas?

:path=/static-assets/pdf/content-code-examples/how-to/find-replace-text-on-multiple-pages.cs
using IronPdf;

string html = @"<p> .NET6 </p>
<p> This is 1st Page </p>
<div style = 'page-break-after: always;'></div>
<p> This is 2nd Page</p>
<div style = 'page-break-after: always;'></div>
<p> .NET6 </p>
<p> This is 3rd Page</p>";

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf(html);

string oldText = ".NET6";
string newText = ".NET7";

int[] pages = { 0, 2 };

// Replace text on page 1 & 3
pdf.ReplaceTextOnPages(pages, oldText, newText);

pdf.SaveAs("replaceTextOnMultiplePages.pdf");
Imports IronPdf

Private html As String = "<p> .NET6 </p>
<p> This is 1st Page </p>
<div style = 'page-break-after: always;'></div>
<p> This is 2nd Page</p>
<div style = 'page-break-after: always;'></div>
<p> .NET6 </p>
<p> This is 3rd Page</p>"

Private renderer As New ChromePdfRenderer()

Private pdf As PdfDocument = renderer.RenderHtmlAsPdf(html)

Private oldText As String = ".NET6"
Private newText As String = ".NET7"

Private pages() As Integer = { 0, 2 }

' Replace text on page 1 & 3
pdf.ReplaceTextOnPages(pages, oldText, newText)

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

Ao trabalhar com documentos de várias páginas, considere implementar a compressão PDF para otimizar o tamanho dos arquivos após as operações de substituição de texto, especialmente ao lidar com documentos grandes ou cenários de processamento em lote.

Como posso usar uma fonte personalizada ao substituir o texto?

O método ReplaceTextOnPage também permite usar uma fonte e tamanho personalizados. Primeiro, adicione a fonte ao PDF e, em seguida, passe o nome da fonte como parâmetro para o método. No exemplo a seguir, utilizo a fonte Pixelify Sans . A implementação de fontes personalizadas é particularmente importante para manter a consistência da marca ou ao trabalhar com idiomas internacionais e suporte a UTF-8 .

Quais são os passos necessários para a implementação de fontes personalizadas?

:path=/static-assets/pdf/content-code-examples/how-to/find-replace-text-custom-font.cs
using IronPdf;
using System.IO;

ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Use custom font .NET6</h1>");

string oldText = ".NET6";
string newText = ".NET7";

// Add custom font
byte[] fontByte = File.ReadAllBytes(@".\PixelifySans-VariableFont_wght.ttf");
var pdfFont = pdf.Fonts.Add(fontByte);

// Use custom font
pdf.ReplaceTextOnPage(0, oldText, newText, pdfFont, 24);

pdf.SaveAs("replaceCustomText.pdf");
Imports IronPdf
Imports System.IO

Private renderer As New ChromePdfRenderer()
Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Use custom font .NET6</h1>")

Private oldText As String = ".NET6"
Private newText As String = ".NET7"

' Add custom font
Private fontByte() As Byte = File.ReadAllBytes(".\PixelifySans-VariableFont_wght.ttf")
Private pdfFont = pdf.Fonts.Add(fontByte)

' Use custom font
pdf.ReplaceTextOnPage(0, oldText, newText, pdfFont, 24)

pdf.SaveAs("replaceCustomText.pdf")
$vbLabelText   $csharpLabel
Comparação mostrando o uso de fontes personalizadas na migração do .NET 6 para o .NET 7 com seta para baixo.

Cenários avançados de substituição de texto

Além da simples substituição de texto, o IronPDF oferece recursos avançados para cenários complexos. Ao trabalhar com modelos ou documentos dinâmicos, combine a substituição de texto com outros recursos, como carimbo de texto e imagens ou adição de assinaturas digitais . Para aplicações que exigem processamento em lote, implemente a substituição de texto juntamente com recursos assíncronos e multithreading para otimizar o desempenho ao processar vários PDFs simultaneamente. Isso é particularmente útil em ambientes corporativos onde a taxa de transferência de documentos é crucial. Ao substituir informações sensíveis, explore os recursos de redação do IronPDF para a remoção permanente de dados confidenciais, garantindo a conformidade com as normas de proteção de dados.

Perguntas frequentes

Como faço para substituir o texto em todas as páginas de um PDF usando C#?

Com o IronPDF, você pode substituir facilmente o texto em todas as páginas usando o método ReplaceTextOnAllPages(). Basta carregar seu documento PDF, chamar esse método com os parâmetros de texto antigo e novo e salvar o documento atualizado. Esse recurso é perfeito para correções em lote e atualizações de modelos.

Posso substituir o texto apenas em páginas específicas, em vez de no documento inteiro?

Sim, o IronPDF oferece o método ReplaceTextOnPage() que permite selecionar páginas específicas para substituição de texto. Isso proporciona controle preciso sobre quais páginas serão modificadas, sendo ideal para atualizações seletivas em documentos com várias páginas.

O que acontece se o texto que eu quero substituir não for encontrado no PDF?

Quando o IronPDF não consegue localizar o texto especificado para substituição, ele gera uma exceção com uma mensagem de erro clara indicando que o texto não foi encontrado. Isso ajuda a lidar com casos em que o texto de busca pode não existir no documento.

É possível substituir um texto que contenha caracteres de nova linha?

Sim, a funcionalidade de substituição de texto do IronPDF oferece suporte completo a caracteres de nova linha. Você pode substituir o texto antigo por novas sequências que incluem quebras de linha integradas, mantendo a formatação e a estrutura adequadas do documento para conteúdo com várias linhas.

Posso usar a substituição de texto em PDFs criados a partir de HTML?

Com certeza! A substituição de texto do IronPDF funciona perfeitamente em PDFs gerados a partir da conversão de HTML. Seja um PDF criado a partir de HTML ou um documento existente importado, o método ReplaceTextOnAllPages() funciona da mesma forma.

Quais são os principais passos para implementar a substituição de texto em um PDF?

O processo com o IronPDF envolve cinco etapas simples: Primeiro, baixe e instale a biblioteca. Segundo, renderize ou importe seu documento PDF. Terceiro, use ReplaceTextOnAllPages() para fazer alterações em todo o documento. Quarto, opcionalmente, especifique os números de página para substituição direcionada. Finalmente, salve o PDF editado usando SaveAs().

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.