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 replace text pode ser aplicada a qualquer objeto PdfDocument, seja recém-renderizado ou importado. Use 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 PDFs existentes .

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 alcançar isso, adicione caracteres de nova linha (\n) à nova string. Usando o exemplo acima, substitua newText por .NET7\nnewline ao invés 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 texto em uma página específica e o método ReplaceTextOnPages para substituir 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 substituo 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.

Icon Quote related to Como faço para substituir texto em várias páginas?

Minha biblioteca favorita desse tipo é o IronPDF. Ele permite a manipulação rápida e eficiente de arquivos PDF. Além disso, possui muitos recursos valiosos, como a exportação para o formato PDF/A e a assinatura digital de documentos PDF.

Milan Jovanovic related to Como faço para substituir texto em várias páginas?

Milan Jovanovic

Microsoft MVP

Veja o estudo de caso
Icon Quote related to Como faço para substituir texto em várias páginas?

Com o IronOCR, podemos economizar US$ 40.000 por ano em processamento manual, ao mesmo tempo que aumentamos a produtividade e liberamos recursos para tarefas de alto impacto. Eu o recomendo fortemente.

Brent Matzelle related to Como faço para substituir texto em várias páginas?

Brent Matzelle

Diretor de Tecnologia, OPYN

Veja o estudo de caso
Icon Quote related to Como faço para substituir texto em várias páginas?

O IronSuite desempenha um papel crucial nas nossas operações. Estas são ferramentas que aumentam a eficiência no negócio, incluindo a criação de plantas baixas e melhoria na gestão de inventário.

David Jones related to Como faço para substituir texto em várias páginas?

David Jones

Engenheiro(a) de Software Líder, Agorus Build

Veja o estudo de caso

Como posso usar uma fonte personalizada ao substituir o texto?

O método ReplaceTextOnPage também permite que você use uma fonte personalizada e tamanho. Primeiro, adicione a fonte ao PDF, depois 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 19,936,792 | Versão: 2026.7 recém-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.