Belgeler, dijital çağda giderek dijital hale geliyor. İş ortamında belgeler genellikle Microsoft Word ve onun belge tabanlı Word dosyası ile ilişkilendirilir. Microsoft Word belgelerini yazmak ve düzenlemek, büyük organizasyonlarda bilgi paylaşımının temeli haline gelmiştir. Ancak, belgeleri manuel olarak oluşturmak ve düzenlemek zahmetli bir süreç olabilir; Ayrıca, Word üretimini programatik olarak otomatikleştirmek de kolay bir iş değildir, çünkü birçok açık kaynak kütüphanesi bağımlılık olarak Microsoft Office Word'e güvenir.

Ancak, Word belgelerini yönetmek ve oluşturmak bu kadar zor olmak zorunda değil. IronWord, Microsoft Office Word'e bağımlı olmayan ve kullanıcıların tüm belgeyi kişiselleştirmesine izin veren C# Word Kütüphanesi, aynı zamanda belgelerin programatik olarak oluşturulmasını ve belge şablonları oluşturulmasını sağlar.

Bugünkü tutorialde, IronWord kullanarak programatik olarak bir Microsoft Word Belgesi nasıl oluşturulacağını ve kısa örnekler sunacağımı kısaca açıklayacağım.

IronWord: Bir C# Word Kütüphanesi

IronWord, geliştiricilerin C# kullanarak Word belgeleri oluşturup düzenlemesine olanak tanıyan, Microsoft Office veya Word Interop gibi geleneksel bağımlılıklara ihtiyaç duymayan, son derece güvenilir ve kullanıcı dostu bir C# Docx kütüphanesidir. Ayrıca, geniş bir belgeler arşivine sahiptir ve .NET 8, 7, 6, Framework, Core ve Azure için tam destek sunar, bu da onu çoğu uygulama için evrensel olarak uyumlu kılar. Bu düzeydeki esneklik, uğraştığınız her türlü uygulama için mükemmel bir seçim yapar.

Ortamı ayarlama

Bu örnek için Visual Studio kullanarak bir konsol uygulaması oluşturacağız ve boş Word belgelerinin nasıl oluşturulacağını ve IronWord Kütüphanesi ile nasıl manipüle edileceğini göstereceğiz. Bu sonraki adıma geçmeden önce, Visual Studio'yu kurduğunuzdan emin olun.

Öncelikle yeni bir konsol uygulaması oluşturalım.

Sonra proje adını verin ve yeri kaydedin, aşağıda gösterildiği gibi.

Son olarak, istenen Framework'u seçin.

C# Word Kütüphanesinin Kurulumu

Boş konsol uygulamasını oluşturduktan sonra, IronWord'ı NuGet Paket Yöneticisi üzerinden indireceğiz.

"NuGet Paketlerini Yönet" üzerine tıklayın ve aşağıda gösterildiği gibi "Tarayıcı" sekmesinde IronWord arayın.

Daha sonra, yeni oluşturulan projeye kurun.

Alternatif olarak, IronWord'u kurmak için komut satırında şu komutu yazabilirsiniz.

Install-Package IronWord

Artık her şey hazır ve gitmeye hazırken, Word belgeleri oluşturmanın bir örneğine geçelim.

Lisans Anahtarı

Lütfen IronWord'un çalışması için bir lisans anahtarı gerektirdiğini unutmayın. Bu linke giderek bir deneme anahtarını ücretsiz olarak alabilirsiniz.

// 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"

Deneme anahtarını aldıktan sonra, bu değişkeni projenizde ayarlayın.

Yeni Bir Word Belgesi Oluşturma

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Create a textrun
        Text textRun = new Text("Sample text");
        Paragraph paragraph = new Paragraph();
        paragraph.AddChild(textRun);

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

        // Export docx
        doc.SaveAs("document.docx");
    }
}

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Create a textrun
        Text textRun = new Text("Sample text");
        Paragraph paragraph = new Paragraph();
        paragraph.AddChild(textRun);

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

        // Export docx
        doc.SaveAs("document.docx");
    }
}

Imports IronWord
Imports IronWord.Models

Friend Class Program
	Shared Sub Main()
		' Create a textrun
		Dim textRun As New Text("Sample text")
		Dim paragraph As New Paragraph()
		paragraph.AddChild(textRun)

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

		' Export docx
		doc.SaveAs("document.docx")
	End Sub
End Class

Imports IronWord
Imports IronWord.Models

Friend Class Program
	Shared Sub Main()
		' Create a textrun
		Dim textRun As New Text("Sample text")
		Dim paragraph As New Paragraph()
		paragraph.AddChild(textRun)

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

		' Export docx
		doc.SaveAs("document.docx")
	End Sub
End Class

Açıklama

1. Öncelikle IronWord Kütüphanesi ve modellerini örnek koda tanıtıyoruz.
2. Yeni bir Text değişkeni oluşturuyoruz. Bu değişken, Word belgesine metin eklememizi sağlar.
3. Sonrasında textRun öğesini bir Paragraph içerisine ekliyoruz. Bu, metni iki ayırarak kolayca manipüle etmemize olanak tanır.
4. paragraph parametresini yeni bir WordDocument sınıfına geçiriyoruz ve yeni bir belge nesnesi oluşturuyoruz.
5. Son olarak, belgeyi "document.docx" olarak bir Word dosyasına kaydediyoruz.

Önceki örnekte, temel metin ile bir Word belgesi oluşturduk. Metni özelleştirmek ve metin efektleri eklemek gibi daha gelişmiş özelliklerle bir örnek yapalım.

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Ensure to set up the license key
        IronWord.License.LicenseKey = "YOUR-KEY";

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

        // Create sample texts with styles
        Text introText = new Text("This is an example paragraph with italic and bold styling.");
        TextStyle italicStyle = new TextStyle()
        {
            IsItalic = true
        };
        Text italicText = new Text("Italic example sentence.");
        italicText.Style = italicStyle;

        TextStyle boldStyle = new TextStyle()
        {
            IsBold = true
        };
        Text boldText = new Text("Bold example sentence.");
        boldText.Style = boldStyle;

        // Create a paragraph and add texts
        Paragraph paragraph = new Paragraph();
        paragraph.AddText(introText);
        paragraph.AddText(italicText);
        paragraph.AddText(boldText);

        // Add paragraph to the document
        doc.AddParagraph(paragraph);

        // Export the document
        doc.SaveAs("save_document.docx");
    }
}

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Ensure to set up the license key
        IronWord.License.LicenseKey = "YOUR-KEY";

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

        // Create sample texts with styles
        Text introText = new Text("This is an example paragraph with italic and bold styling.");
        TextStyle italicStyle = new TextStyle()
        {
            IsItalic = true
        };
        Text italicText = new Text("Italic example sentence.");
        italicText.Style = italicStyle;

        TextStyle boldStyle = new TextStyle()
        {
            IsBold = true
        };
        Text boldText = new Text("Bold example sentence.");
        boldText.Style = boldStyle;

        // Create a paragraph and add texts
        Paragraph paragraph = new Paragraph();
        paragraph.AddText(introText);
        paragraph.AddText(italicText);
        paragraph.AddText(boldText);

        // Add paragraph to the document
        doc.AddParagraph(paragraph);

        // Export the document
        doc.SaveAs("save_document.docx");
    }
}

Imports IronWord
Imports IronWord.Models

Friend Class Program
	Shared Sub Main()
		' Ensure to set up the license key
		IronWord.License.LicenseKey = "YOUR-KEY"

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

		' Create sample texts with styles
		Dim introText As New Text("This is an example paragraph with italic and bold styling.")
		Dim italicStyle As New TextStyle() With {.IsItalic = True}
		Dim italicText As New Text("Italic example sentence.")
		italicText.Style = italicStyle

		Dim boldStyle As New TextStyle() With {.IsBold = True}
		Dim boldText As New Text("Bold example sentence.")
		boldText.Style = boldStyle

		' Create a paragraph and add texts
		Dim paragraph As New Paragraph()
		paragraph.AddText(introText)
		paragraph.AddText(italicText)
		paragraph.AddText(boldText)

		' Add paragraph to the document
		doc.AddParagraph(paragraph)

		' Export the document
		doc.SaveAs("save_document.docx")
	End Sub
End Class

Imports IronWord
Imports IronWord.Models

Friend Class Program
	Shared Sub Main()
		' Ensure to set up the license key
		IronWord.License.LicenseKey = "YOUR-KEY"

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

		' Create sample texts with styles
		Dim introText As New Text("This is an example paragraph with italic and bold styling.")
		Dim italicStyle As New TextStyle() With {.IsItalic = True}
		Dim italicText As New Text("Italic example sentence.")
		italicText.Style = italicStyle

		Dim boldStyle As New TextStyle() With {.IsBold = True}
		Dim boldText As New Text("Bold example sentence.")
		boldText.Style = boldStyle

		' Create a paragraph and add texts
		Dim paragraph As New Paragraph()
		paragraph.AddText(introText)
		paragraph.AddText(italicText)
		paragraph.AddText(boldText)

		' Add paragraph to the document
		doc.AddParagraph(paragraph)

		' Export the document
		doc.SaveAs("save_document.docx")
	End Sub
End Class

Kod Açıklaması

1. Yukarıdaki örnekte olduğu gibi, Text nesnesini oluşturuyoruz ve belge için örnek metni ekliyoruz.
2. Sonra yeni bir TextStyle nesnesi oluşturuyoruz ve özellik olarak IsItalic'i true olarak atıyoruz, metnin italik olması gerektiğini belirtiyoruz.
3. Aynısını boldText değişkeni için yapıyoruz ve özellik olarak true'i IsBold'a atıyoruz.
4. Sonra TextStyle değişkenlerini kendi Text değişkenlerine atıyoruz.
5. Bir Paragraph değişkeni oluşturuyoruz ve italik ve kalın metni eklemek için AddText metodunu çağırıyoruz.
6. Paragrafı belgeye, AddParagraph metodunu kullanarak ekliyoruz.
7. Son olarak, belgeyi "save_document.docx" olarak kaydediyoruz.

Yukarıdaki örnek, geliştiricilerin IronWord kullanarak kullanabileceği yazı tiplerini ve stilleri gösterir. Italik ve kalın metin efektlerinin yanı sıra, IronWord ayrıca geliştiricilere çeşitli senaryolarda benzersiz Word belgeleri oluşturmak için tüm seçenekleri sunduğundan emin olmak için başka özellikler de sunar.

Sonuç

IronWord kütüphanesinin C# ile programatik olarak Word belgeleri oluşturmanın ne kadar kolay olduğunu gösteren gösterilerimizde gördük. Kütüphanenin esnekliği ve ölçeklenebilirliği, geliştiriciler için gerçek dünya senaryolarında değerli bir araç haline getirir, örneğin bir Word belgesindeki metin, yazı tipi ve stil özelleştirmesi yapma gibi. Word'un diğer uygulamalarla nasıl entegre olduğunu anlamak, geliştiricilere karşılaştıkları zorluklara ek çözümler sunar.

IronWord, ücretsiz bir deneme lisansı sağlar.