Günümüzde, Microsoft Word belgeleri ofis çalışmaları ve profesyonel ve kişisel iletişim ile eşanlamlıdır. Bu nedenle, yazılım geliştiricilerin kullanıcılarına uygulamalarında göstermek istediği görevleri otomatikleştirme açısından, Word belgeleriyle programatik olarak etkileşim kurmak kritik önem taşır. Her ne kadar kullanılabilen birçok kütüphane olsa da, hepsi diğerleri kadar sağlam değildir. Ancak, diğerlerinden öne çıkan bir aday IronWord. IronWord, C# Word DOCX kütüphanesi olarak güvenilir ve sağlam bir seçenek sunarak, Word belgeleriyle çalışmayı kolay ve anlaşılır hale getirir.

Bu makale, IronWord'u kullanarak Word belgelerini hızlı bir şekilde okuma konusunda nasıl yararlanabileceğimizi kısa örneklerle inceleyecek.

How To Read a Word File Using C#

1. Visual Studio'da bir Konsol Uygulaması oluşturun

2. IronWord C# DOCX kütüphanesini yükleyin

3. WordDocument sınıfını kullanarak yeni bir Word belgesi oluşturun

4. Word belgesine metin ekleyin

5. Paragraph sınıfını kullanarak her paragrafı yineleyin

6. İçeriği görüntüleyin

IronWord: C# DOCX Kütüphanesi

IronWord, uygulamalara Word belgelerini entegre etmenin zorluğunu ortadan kaldıran, esnek ve ölçeklenebilir bir kütüphane olup, kolay kullanılabilir bir API sunar. Basit metin içeren bir Word belgesini uygulamanıza eklemek ve entegre etmek veya kullanıcıları göstermek için karmaşık tablolar ve raporlar oluşturmak isteseniz de, IronWord her şeyi kapsar.

İşte en önemli özellikleri:

1. Belge Yönetimi: IronWord, geliştiricilere Word belgelerini kolaylıkla yönetme imkanı sunar. Kullanıcılar metin paragrafları eklemek veya tablolar ve resimler gibi daha karmaşık yapılar eklemek isteseler de, IronWord her şeyi yapabilir.

2. Çapraz Platform Desteği ve Uyumluluk: IronWord, esnek olacak şekilde tasarlanmıştır ve geliştiricilere birden fazla platformda destek sunar. Çeşitli .NET Core (8, 7, 6, 5 ve 3.1+), .NET Standard (2.0+), .NET Framework (4.6.2+) sürümlerini ve hatta Azure'u destekler. Buna ek olarak, geliştiriciler IronWord'u Windows, Linux, macOS ve Android dahil olmak üzere farklı platformlar ve sistemlerde kullanabilirler. En yaygın platformları kapsar ve geliştiricilere çapraz platform uygulamalar hızlıca inşa etme imkanı tanır.

3. Microsoft Office'den Bağımsızlık: .NET uygulamalarında Word belgeleri entegre ederken yaygın bir sıkıntı, Interop gibi popüler kütüphanelerin Microsoft Office'in lisanslı bir kurulumunu gerektirmesidir. Ancak, IronWord bu sorunu çözerek bu kısıtlamadan bağımsızdır. Geliştiriciler, Microsoft Word'ün lisansı ve kurulumu tarafından sınırlanmadan Word belgelerinin gücünü tam anlamıyla kullanabilirler.

4. Biçimlendirme Seçenekleri: IronWord, geliştiricilerin belgeyi benzersiz hale getirmelerini sağlayan kapsamlı biçimlendirme ve stil desteği sunar. Geliştiriciler, metinlerine yazı tipleri, renklendirmeler, hizalamalar ve daha karmaşık biçimlendirmeler, örneğin tablo stilleri gibi değişiklikler uygulayabilirler.

5. Kullanım Kolaylığı ve Geniş Destek: Kolay anlaşılır bir API ve açık metod çağrılarının yanı sıra, IronWord, geliştiricilerin IronWord'ü en uygun şekilde kullanmalarına yardımcı olmak için uzatma API referansları ve kod örnekleri sunar.

Visual Studio'da Yeni Bir Konsol Projesi Oluşturma

Örneğe dalmadan önce, Visual Studio'da boş bir konsol projesi oluşturarak başlayalım.

Daha sonra proje için bir ad ve bir kaydetme yeri sağlarız.

Sonraki adımda kullanacağınız .NET çerçevesini seçin. Bu örnekte, .NET 8.0 kullanacağım.

Yeni konsol projesini oluşturup ayarladıktan sonra, C# kelime kütüphanemizi, IronWord'u yükleyelim.

IronWord Yükleme

IronWord yüklemenin iki yolu vardır.

1. NuGet Paket Yöneticisi ile Yükleme

NuGet Paket Yöneticisi aracılığıyla yüklemek için, araçlar üzerine tıklayın ve ardından Manage NuGet Packages for Solution. Arama çubuğunda IronWord'u arayıp **IronWord**'i yükleyin.

2. NuGet Paket Yöneticisi Konsoluyla Yükleme

Alternatif bir yöntem, NuGet Paket Yöneticisi Konsolu aracılığıyla yüklemektir. Bunu yapmak için, konsolda aşağıdaki komutu çalıştırın:

Install-Package IronWord

Lisans Anahtarı

Lütfen, IronWord'un lisans anahtarı olmadan çalışmadığını unutmayın; ücretsiz deneme kapsında bir anahtar alabilirsiniz.

Deneme anahtarı aldıktan sonra, bu değişkenin projenizde ayarlı olduğuna emin olun.

// Replace the license key variable with the trial key you obtained
IronWord.License.LicenseKey = "REPLACE-WITH-YOUR-KEY";

// Replace the license key variable with the trial key you obtained
IronWord.License.LicenseKey = "REPLACE-WITH-YOUR-KEY";

' Replace the license key variable with the trial key you obtained
IronWord.License.LicenseKey = "REPLACE-WITH-YOUR-KEY"

' Replace the license key variable with the trial key you obtained
IronWord.License.LicenseKey = "REPLACE-WITH-YOUR-KEY"

Reading Word Documents in C#

Gereklilikleri yükledikten sonra, Microsoft Word belgesini okumanın kolaylığını, IronWord kullanarak aşağıdaki kodda göstereceğiz.

Öncelikle gerekli ad alanlarını içe aktarırız. IronWord kullanarak, yeni bir belge oluşturur ve örnek metin ekleriz. Ardından Word belgesi içindeki metni yazdırmak için WordDocument nesnesini kullanarak paragraflara ve metne erişiriz.

using IronWord;
using IronWord.Models;

#region Licensing
// Set the IronWord license key before using the IronWord functionalities
IronWord.License.LicenseKey = "YOUR-KEY-HERE";
#endregion

// Create text run with sample text
Text textRunExample = new Text("Sample text");

// Create a paragraph and add the text run to it
Paragraph paragraphExample = new Paragraph();
paragraphExample.AddChild(textRunExample);

// Create a new Word document with the paragraph
WordDocument doc = new WordDocument(paragraphExample);

// Export the document as a DOCX file
doc.SaveAs("document.docx");

// Access paragraphs and text runs within the document
foreach (Paragraph paragraph in doc.Paragraphs)
{
    foreach (Text textRun in paragraph.Texts)
    {
        // Access text content
        string content = textRun.Text;
        // Display the content to the console
        Console.WriteLine(content);
    }
}

using IronWord;
using IronWord.Models;

#region Licensing
// Set the IronWord license key before using the IronWord functionalities
IronWord.License.LicenseKey = "YOUR-KEY-HERE";
#endregion

// Create text run with sample text
Text textRunExample = new Text("Sample text");

// Create a paragraph and add the text run to it
Paragraph paragraphExample = new Paragraph();
paragraphExample.AddChild(textRunExample);

// Create a new Word document with the paragraph
WordDocument doc = new WordDocument(paragraphExample);

// Export the document as a DOCX file
doc.SaveAs("document.docx");

// Access paragraphs and text runs within the document
foreach (Paragraph paragraph in doc.Paragraphs)
{
    foreach (Text textRun in paragraph.Texts)
    {
        // Access text content
        string content = textRun.Text;
        // Display the content to the console
        Console.WriteLine(content);
    }
}

Imports IronWord
Imports IronWord.Models

#Region "Licensing"
' Set the IronWord license key before using the IronWord functionalities
IronWord.License.LicenseKey = "YOUR-KEY-HERE"
'#End Region

' Create text run with sample text
Dim textRunExample As New Text("Sample text")

' Create a paragraph and add the text run to it
Dim paragraphExample As New Paragraph()
paragraphExample.AddChild(textRunExample)

' Create a new Word document with the paragraph
Dim doc As New WordDocument(paragraphExample)

' Export the document as a DOCX file
doc.SaveAs("document.docx")

' Access paragraphs and text runs within the document
For Each paragraph As Paragraph In doc.Paragraphs
	For Each textRun As Text In paragraph.Texts
		' Access text content
		Dim content As String = textRun.Text
		' Display the content to the console
		Console.WriteLine(content)
	Next textRun
Next paragraph

Imports IronWord
Imports IronWord.Models

#Region "Licensing"
' Set the IronWord license key before using the IronWord functionalities
IronWord.License.LicenseKey = "YOUR-KEY-HERE"
'#End Region

' Create text run with sample text
Dim textRunExample As New Text("Sample text")

' Create a paragraph and add the text run to it
Dim paragraphExample As New Paragraph()
paragraphExample.AddChild(textRunExample)

' Create a new Word document with the paragraph
Dim doc As New WordDocument(paragraphExample)

' Export the document as a DOCX file
doc.SaveAs("document.docx")

' Access paragraphs and text runs within the document
For Each paragraph As Paragraph In doc.Paragraphs
	For Each textRun As Text In paragraph.Texts
		' Access text content
		Dim content As String = textRun.Text
		' Display the content to the console
		Console.WriteLine(content)
	Next textRun
Next paragraph

Yukarıdaki koddan kelime dosyalarını okuma yöntemlerinin ve parametrelerinin derinlemesine incelemesini yapalım.

1. Öncelikle bir Text objesi oluştururuz ve "Örnek metin" dizesini buna atarız.

2. Ardından bir Paragraph obje oluştururuz ve "textRunExample"'yi buna ekleriz.

3. Ayrıca bir WordDocument nesnesi oluştururuz, ona WordDocument doc, adını verir ve paragraf içeren yeni bir Word belgesi oluşturmak için paragraphExample'ı aktarırız.

4. Kod, daha sonra kullanılmak üzere Word belgesini "document.docx" dosya adı ile kaydeder.

5. Sadece oluşturduğumuz Word belgesindeki paragraflara erişmek için, WordDocument nesnesinin "Paragraphs" özelliğine erişiriz. "Paragraphs" özelliği bir listedir. Bu yüzden tekrar etmek için bir foreach döngüsü çağırırız.

6. Paragraf içindeki metni elde etmek için, Paragraphs'ün "Texts" özelliğine erişiriz. Bu aynı zamanda Text listesini de döndürür.

7. Son olarak, Text'i "content" adında bir dize değişkenine atarız ve konsola yazdırırız.

Konsol çıktısı

Reading an existing Word document in C#

Önceki örnekte, yeni bir Word belgesini programatik olarak oluşturduk ve içeriğini okuduk. Birkaç kod değişikliği yaparak, mevcut bir Word belgesini okumak için benzer adımları izleyebiliriz.

Giriş Belgesi

using IronWord;
using IronWord.Models;

#region Licensing
// Set the IronWord license key before using the IronWord functionalities
IronWord.License.LicenseKey = "YOUR-KEY-HERE";
#endregion

// Load an existing Word document
WordDocument doc = new WordDocument("existing_document.docx");

// Access paragraphs and text runs within the document
foreach (Paragraph paragraph in doc.Paragraphs)
{
    foreach (Text textRun in paragraph.Texts)
    {
        // Access text content
        string content = textRun.Text;
        // Display the content to the console
        Console.WriteLine(content);
    }
}

using IronWord;
using IronWord.Models;

#region Licensing
// Set the IronWord license key before using the IronWord functionalities
IronWord.License.LicenseKey = "YOUR-KEY-HERE";
#endregion

// Load an existing Word document
WordDocument doc = new WordDocument("existing_document.docx");

// Access paragraphs and text runs within the document
foreach (Paragraph paragraph in doc.Paragraphs)
{
    foreach (Text textRun in paragraph.Texts)
    {
        // Access text content
        string content = textRun.Text;
        // Display the content to the console
        Console.WriteLine(content);
    }
}

Imports IronWord
Imports IronWord.Models

#Region "Licensing"
' Set the IronWord license key before using the IronWord functionalities
IronWord.License.LicenseKey = "YOUR-KEY-HERE"
'#End Region

' Load an existing Word document
Dim doc As New WordDocument("existing_document.docx")

' Access paragraphs and text runs within the document
For Each paragraph As Paragraph In doc.Paragraphs
	For Each textRun As Text In paragraph.Texts
		' Access text content
		Dim content As String = textRun.Text
		' Display the content to the console
		Console.WriteLine(content)
	Next textRun
Next paragraph

Imports IronWord
Imports IronWord.Models

#Region "Licensing"
' Set the IronWord license key before using the IronWord functionalities
IronWord.License.LicenseKey = "YOUR-KEY-HERE"
'#End Region

' Load an existing Word document
Dim doc As New WordDocument("existing_document.docx")

' Access paragraphs and text runs within the document
For Each paragraph As Paragraph In doc.Paragraphs
	For Each textRun As Text In paragraph.Texts
		' Access text content
		Dim content As String = textRun.Text
		' Display the content to the console
		Console.WriteLine(content)
	Next textRun
Next paragraph

İki örnek arasındaki temel fark, WordDocument nesnesine geçirilen parametredir. Yeni bir belge oluşturmak yerine, mevcut bir Word dosyasını yükleriz. Diğer kısımlar, diğer örnekle aynıdır.

Konsol çıktısı

Sonuç

Örnekler boyunca, IronWord kütüphanesini C# dilinde programatik olarak Word belgelerini manipüle etmek ve okumak için kullanmanın ne kadar kolay olduğunu gösterdik. IronWord kütüphanesinin esnekliği ve ölçeklenebilirliği, geliştiricilerin IronWord'u pratik, gerçek yaşam örneklerinde kullanmasına imkan tanıyan değerli bir araç yapar, örneğin şablonları doldurma, rapor oluşturma ve belgeleri toplu işleme. Word'un uygulamalarla nasıl entegre olduğunu anlamak değerlidir çünkü geliştiricilere sorunlarına daha fazla çözüm sunar.

Ayrıca, geliştiriciler, bir ücretsiz deneme lisansı sunduğu için, IronWord'un kapsamlı özelliklerini bir süreliğine test edebilirler. Kullanım kolaylığının yanı sıra IronWord, geliştiriciler için üretim sırasında karşılaşabilecekleri sürekli hayal kırıklığını hafifletmek amacıyla detaylı dökümantasyon ve 24/5 destek sunar. IronWord ile başlamanıza yardımcı olmak için çeşitli öğreticiler ve bir dizi kod örnekleri da sunuyoruz.

IronWord ile çeşitli yönleri ücretsiz deneme lisansı ile test ettikten sonra, Lite'dan Professional'a yükselen ve fiyatları $599'dan başlayan Lite geliştirici lisansımızı satın alabilirsiniz. Daha fazla bilgi için lütfen lisanslama sayfamıza göz atın.