How to Replace Text in a Word Document

Automatizar el reemplazo de texto en documentos de Word es una necesidad común, ya sea que estés personalizando plantillas, actualizando informes o gestionando contenido masivo. IronWord es una biblioteca de C# diseñada para hacer que esta tarea sea sencilla y eficiente.

Una ventaja clave de IronWord es que manipula documentos de Word directamente, sin depender de Microsoft Office Interop. Esto significa que no necesitas tener Word instalado en tu servidor, lo que resulta en una solución significativamente más rápida, confiable y escalable para procesos de backend y aplicaciones web.

En esta guía práctica, mostraremos ejemplos de código para enseñarte lo fácil que es encontrar y reemplazar texto en cualquier documento de Word.

como-encabezado:2(Inicio rápido: Reemplazar texto en documentos de Word fácilmente)

Esta guía rápida demuestra cómo reemplazar rápidamente texto en un documento de Word usando IronWord. Con solo unas pocas líneas de C#, puedes cargar un archivo DOCX, reemplazar el texto especificado y guardar el documento actualizado. Este proceso eficiente asegura que los desarrolladores puedan mejorar la automatización de documentos sin la necesidad de Microsoft Office Interop, haciéndolo ideal para procesos de backend y aplicaciones web.

Ejemplo de reemplazo de texto

Reemplazar texto dentro de un documento de Word es intuitivo con IronWord. Primero, cargamos un documento existente. Luego, accedemos a la colección de párrafos a través de Paragraphs y usamos el método ReplaceText en un párrafo específico.

El método ReplaceText toma dos parámetros de cadena: el texto a encontrar y el texto con el que se va a reemplazar.

ConsejosEl método ReplaceText distingue entre mayúsculas y minúsculas y reemplaza todas las instancias de la cadena dentro del párrafo seleccionado.

ConsejosTodas las listas de objetos usadas en este ejemplo siguen una indexación basada en cero.

Entrada

En este ejemplo, usaremos este documento de Word de muestra que contiene dos párrafos, ambos con el texto "old text".

class="content-img-align-center">

class="center-image-wrapper">

Código

Aquí está el código a continuación, reemplazaremos el primer párrafo de "old text" con la palabra "new text".

:path=/static-assets/word/content-code-examples/how-to/replace-words.cs

using IronWord;

// Open existing Word
WordDocument doc = new WordDocument("sample.docx");

// Replace the first paragraph's old text with new text
doc.Paragraphs[0].ReplaceText("old text", "new text");

// Save updated Word Document
doc.SaveAs("updated.docx");

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText   $csharpLabel

Resultado

class="content-img-align-center">

class="center-image-wrapper">

Como se puede ver en el archivo de salida, solo se ha cambiado el texto del primer párrafo, mientras que el segundo permanece intacto.

Reemplazo de texto múltiple

Para reemplazar cada aparición de una palabra en todo el documento, recorra la colección Paragraphs y aplique el método ReplaceText a cada una.

Usaremos el mismo archivo sample.docx que antes. Si el texto a reemplazar no se encuentra en un párrafo, no se realiza ninguna operación y el bucle continúa al siguiente párrafo.

Por favor notaSi el texto que deseas reemplazar no se encuentra, no se realizará ninguna operación.

Código

Aquí está el código a continuación, reemplazaremos el primer párrafo de "old text" con la palabra "new text".

:path=/static-assets/word/content-code-examples/how-to/replace-words-multiple.cs

using IronWord;

// Open existing Word
WordDocument doc = new WordDocument("sample.docx");

// Loop through each paragraph to find and replace text
for (int i = 0; i < doc.Paragraphs.Count; i++)
{
    // Replace all occurrences of "old text" with "new text" in the current paragraph
    doc.Paragraphs[i].ReplaceText("old text", "new text");
}

// Save updated Word Document
doc.SaveAs("updated.docx");

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText   $csharpLabel

Resultado

class="content-img-align-center">

class="center-image-wrapper">

Como se puede ver en este documento de Word actualizado, ambos párrafos han sido reemplazados con la palabra "new text".

Buscar texto

Si necesitas verificar que existe un texto antes de realizar una operación, puedes usar el método FindText. Este método busca en todo el documento y devuelve el primer TextElement que coincida con la consulta de búsqueda.

A continuación se muestra un ejemplo de búsqueda del texto antiguo en el documento de Word mencionado anteriormente.

Código

:path=/static-assets/word/content-code-examples/how-to/replace-words-find-text.cs

using IronWord;
using System;

// Open existing Word
WordDocument doc = new WordDocument("sample.docx");

// Returns the first TextContent element that contains the specified text.
Console.WriteLine(doc.FindText("old text"));

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText   $csharpLabel

Resultado

class="content-img-align-center">

class="center-image-wrapper">

Como puedes ver, devolvió el texto coincidente.

AdvertenciaSi FindText no devuelve nada, el texto no existe en el documento. Verifica que tu término de búsqueda esté correctamente escrito y coincida con el caso del texto en el documento.

Asegúrese de que su término de búsqueda esté escrito correctamente y coincida con el caso del texto en el documento.