How to Replace Text in a Word Document with C

Giriş Belgesi Nasıl Görünür?

Bu örnekte, iki paragraf içeren ve her ikisinde de "eski metin" bulunan bir örnek Word belgesi kullanacağız. Bu basit yapı, metin değiştirmenin paragraf seviyesinde nasıl çalıştığını gösterir.

Değiştirme Kodunu Nasıl Yazarım?

İşte ilk paragrafın "eski metin"ini "yeni metin" ile değiştirmek için kod. Belirli paragrafları hedeflemek için nasıl indeks notasyonu kullandığımıza dikkat edin, bu da hangi içeriğin değiştirileceği üzerinde bize kesin kontrol sağlar:

: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");

Imports IronWord

' Open existing Word
Dim doc As 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")

Yukarıdaki kod, IronWord ile metin değiştirmenin basitliğini göstermektedir. Belgeyi yükleyerek, belirli bir paragrafı hedefleyip ReplaceText çağırarak, sadece birkaç satır kodla belge içeriğini değiştirebilirsiniz. Bu yaklaşım, geleneksel Office Interop yöntemlerinden daha basittir.

Çıktı Nasıl Görünür?

Çıktı dosyasından görebileceğiniz üzere, sadece birinci paragrafın metni değişmiş olup, ikinci paragraf etkilenmemiştir. Bu seçici değiştirme yeteneği, tüm belgeyi etkilemeden belirli bölümleri güncellemeniz gerektiğinde önemlidir.

Birden Çok Değiştirme İçin Hangi Kodu Kullanırım?

Tüm belge boyunca 'eski metin' tüm oluşumlarıyla 'yeni metin' ile değiştirilecek kod:

: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");

Imports IronWord

' Open existing Word
Dim doc As New WordDocument("sample.docx")

' Loop through each paragraph to find and replace text
For i As Integer = 0 To doc.Paragraphs.Count - 1
    ' Replace all occurrences of "old text" with "new text" in the current paragraph
    doc.Paragraphs(i).ReplaceText("old text", "new text")
Next

' Save updated Word Document
doc.SaveAs("updated.docx")

Bu döngü yaklaşımı, belgenizin tam kapsamını sağlar. Her paragrafı dolaşarak, hedef metninizin tüm örneklerinin değiştirildiğinden emin olursunuz. Bu yöntem, şirket adlarını değiştirme, terminolojiyi güncelleme veya belge boyunca tutarlı biçimlendirme uygulama gibi toplu güncellemeler için özellikle yararlıdır.

Birden Çok Değiştirmeden Sonra Belge Nasıl Görünecek?

Güncellenmiş Word Belgesinden görebileceğiniz üzere, her iki paragraf "yeni metin" ile değiştirildi. Bu, kapsamlı metin değişimi için döngü yaklaşımının etkinliğini göstermektedir.

Metni Değiştirmeden Önce Nasıl Doğrularım?

Metnin varlığını doğrulamanız gerektiğinde, FindText yöntemini kullanın. Bu yöntem, tüm belgeyi arar ve arama sorgusuyla eşleşen ilk TextElement döndürür. Bu doğrulama adımı, belirli içeriğin varlığını doğrulamanız gerektiğinde veya belge içeriğine dayalı koşullu mantık oluştururken yararlıdır.

FindText yöntemi şu senaryolarda özellikle değerlidir:

• Belirli metni içeren belgeleri kaydetmeniz gerektiğinde
• Metin bulunup bulunmadığına göre farklı eylemler gerçekleştirmek istediğinizde
• Belge doğrulama sisteme kurma aşamasındaysanız
• Belge içeriği hakkında raporlar oluşturmanız gerektiğinde

Aşağıda yukarıda bahsedilen Word belgesinde eski metni arama örneği bulunmaktadır.

Metni Bulmak İçin Hangi Kodu Kullanmalıyım?

: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"));

Imports IronWord
Imports System

' Open existing Word
Dim doc As New WordDocument("sample.docx")

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

Bu kod, IronWord ile metin aramanın basitliğini gösterir. FindText yöntemi, metin bulunursa bir TextElement nesnesi döndürür veya bulunamazsa null döndürür, bu da arama sonuçlarına dayalı koşullu mantığı uygulamayı kolaylaştırır.

Metin Sonucu Ne Gösteriyor?

Görebileceğiniz üzere, eşleşen metni döndürdü ve belgede arama teriminin var olduğunu doğruladı. Bu doğrulama yeteneği, çeşitli içerik senaryolarını ele alması gereken sağlam belge işleme uygulamaları oluşturmak için esastır.