How to Replace Text in a Word Document with C

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

Bu örnekte, 'eski metin' içeriğine sahip iki paragraf içeren bu örnek Word belgesini kullanacağız. Bu basit yapı, paragraf düzeyinde metin değiştirmenin nasıl çalıştığını gösterir.

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

İlk paragraftaki 'eski metni' 'yeni metin ile değiştirmek için kod şu şekildedir. Belirli paragrafları hedeflemek için indeks notasyonunu nasıl kullandığımızı fark edin, hangi içeriğin değiştirileceği üzerinde hassas 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österiyor. Belgeyi yükleyerek, belirli bir paragrafı hedefleyerek ve ReplaceText komutunu çağırarak, sadece birkaç satır kodla belge içeriğini değiştirebilirsiniz. Bu yaklaşım, geleneksel Ofis Interop yöntemlerinden daha basit bir yoldur.

Çıkış Nasıl Görünür?

çıktı dosyasında görüldüğü gibi, yalnızca ilk paragrafın metni değiştirilmiş, ikinci paragraf ise değişmeden kalmıştır. Bu seçici değiştirme yeteneği, belirli bölümleri güncellerken tüm belgeyi etkilemeden güncelleme yapmanız gerektiğinde kritik önem taşır.

Çoklu Değiştirmeler İçin Hangi Kod Gereklidir?

İşte tüm belgedeki "eski metin" oluşumlarının "yeni metin" ile değiştirilmesi için 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 tamamını kapsar. Her paragrafı gözden geçirerek, hedef metninizin tüm örneklerinin değiştirileceğinden emin olursunuz. Bu yöntem, tüm belgedeki değişimlerin etkili olmasını sağlamak için, toplu güncellemeler, şirket isimlerini değiştirmek, terminolojiyi güncellemek veya bir belgede tutarlı biçimlendirme uygulamak gibi işlemler için özellikle yararlıdır.

Çoklu Değiştirmelerden Sonra Belge Nasıl Görünecek?

Bu güncellenmiş Word Belgesinden de görebileceğiniz gibi, her iki paragraf da "yeni metin" olarak değiştirilmiştir. Bu, kapsamlı metin değiştirmeleri için döngüsel yaklaşımın etkinliğini gösterir.

Metni Değiştirmeden Metnin Var Olduğunu Nasıl Doğrularım?

Bir işlemi gerçekleştirmeden önce metnin varlığını doğrulamanız gerekiyorsa, FindText yöntemini kullanın. Bu yöntem, belgenin tamamını tarar ve arama sorgusuyla eşleşen ilk TextElement öğesini döndürür. Bu doğrulama adımı, belirli içeriklerin varlığını teyit etmeniz gerektiğinde veya belge içeriğine dayalı koşullu mantık oluştururken faydalı olabilir.

FindText yöntemi özellikle aşağıdaki senaryolarda çok değerlidir:

• Belirli metin içeren belgeleri kaydetmeniz gerekiyor
• Metin bulunursa farklı eylemler gerçekleştirmek istiyorsunuz
• Belge doğrulama sistemi oluşturuyorsunuz
• Belge içeriği hakkında raporlar oluşturmanız gerekiyor

Yukarıda bahsedilen Word belgesindeki eski metni aramanın bir örneği aşağıda verilmiştir

Metin Bulmak için Hangi Kodu Kullanırı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"))

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

Metin Bulma Sonucu Ne Gösterir?

Gördüğünüz gibi, eşleşen metni döndürdü ve bu da arama teriminin belgede var olduğunu doğruluyor. 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.