C# Kullanarak Word Belgesi Nasil Oluşturulur

C# ile Bir Word Belgesi Oluşturmak için Bir Word Şablonu Kullanma

1. Microsoft Visual Studio'da yeni bir proje oluşturun.
2. NuGet paket yöneticisi üzerinden IronWord'u yükleyin.
3. Bir Word Şablon belgesi oluşturun.
4. Bir Word belgesine veri ekleyin ve yeni bir dosya olarak kaydedin.
5. Oluşturulan Word belgesine metin efektleri ekleyin.

IronWord nedir?

IronWord, Microsoft Word belgelerinin programlı bir şekilde oluşturulması, manipüle edilmesi ve yönetilmesini kolaylaştırmak üzere Iron Software tarafından geliştirilen bir .NET kütüphanesidir. Geliştiricilerin Word belgeleri üretme sürecini otomatikleştirmelerini sağlar ve uygulamaları içinde raporlar, faturalar, mektuplar ve diğer belge türlerini dinamik olarak oluşturmayı kolaylaştırır.

Ön Koşullar

Başlamadan önce aşağıdakilere sahip olduğunuzdan emin olun:

• Visual Studio bilgisayarinizda yukludur.
• En son .NET Framework kurulmuş olmalıdır.

Adım 1: Microsoft Visual Studio'da yeni bir proje oluşturun.

Şimdi, yeni bir Visual Studio projesi oluşturarak başlayalım.

Aşağıdaki ekranda konsol uygulama şablonunu seçin.

Proje adını ve konumunu sağlayın.

.NET Sürümünü seçin, tercihen en yeni destekleneni, ve Oluştur'a tıklayın.

Adım 2: IronWord NuGet Paket yöneticisini yükleyin.

IronWord NuGet paketini, Visual Studio'da aşağıdaki gibi NuGet paket yöneticisinden yükleyin.

Alternatif olarak, aşağıdaki komutu kullanarak doğrudan CLI kullanarak yükleyin.

dotnet add package IronWord --version 2024.9.1

dotnet add package IronWord --version 2024.9.1

Adım 3: Bir Word Şablonu belgesi oluşturun.

Şimdi, Word belge üretim sürecinde kullanılmak üzere bir veya iki sayfalık Word şablon belgesi oluşturun.

Dear {Name},

Thanks for purchasing {product}. We are happy to serve you always. Your application dated {Date} has been approved. The product comes with an expiry date of {expiryDate}. Renew the product on or before the expiry date.

Feel free to contact {phone} or {email} for further queries.

Address: {Address}

Thank you,

{Sender}

Şimdi yukarıdaki belgeyi Template.docx olarak kaydedin.

Adım 4: Bir Word belgesine veri ekleme ve yeni bir dosya olarak kaydetme.

using System;
using System.Collections.Generic;
using IronWord;

class Program
{
    static void Main()
    {
        // Set the license key for IronWord
        License.LicenseKey = "your key";

        // Define paths for the template and the output file
        string templatePath = "Template.docx";
        string outputPath = "FilledDocument.docx";

        // Create a new instance of the WordDocument class using the template path
        WordDocument doc = new WordDocument(templatePath);

        // Define a dictionary of placeholders and their replacements
        var replacements = new Dictionary<string, string>
        {
            { "{Name}", "John Doe" },
            { "{Date}", DateTime.Now.ToString("MMMM d, yyyy") },
            { "{Address}", "123 Iron Street, Iron Software" },
            { "{product}", "IronWord" },
            { "{Sender}", "IronSoftware" },
            { "{phone}", "+123 456789" },
            { "{email}", "sale@ironsoftware.com" },
            { "{expiryDate}", DateTime.Now.AddYears(1).ToString("MMMM d, yyyy") },
        };

        // Replace placeholders in the document with actual data
        foreach (var replacement in replacements)
        {
            doc.Texts.ForEach(x => x.Replace(replacement.Key, replacement.Value));
        }

        // Save the filled document
        doc.Save(outputPath);

        // Notify the user that the document has been saved successfully
        Console.WriteLine("Document filled and saved successfully.");
    }
}

using System;
using System.Collections.Generic;
using IronWord;

class Program
{
    static void Main()
    {
        // Set the license key for IronWord
        License.LicenseKey = "your key";

        // Define paths for the template and the output file
        string templatePath = "Template.docx";
        string outputPath = "FilledDocument.docx";

        // Create a new instance of the WordDocument class using the template path
        WordDocument doc = new WordDocument(templatePath);

        // Define a dictionary of placeholders and their replacements
        var replacements = new Dictionary<string, string>
        {
            { "{Name}", "John Doe" },
            { "{Date}", DateTime.Now.ToString("MMMM d, yyyy") },
            { "{Address}", "123 Iron Street, Iron Software" },
            { "{product}", "IronWord" },
            { "{Sender}", "IronSoftware" },
            { "{phone}", "+123 456789" },
            { "{email}", "sale@ironsoftware.com" },
            { "{expiryDate}", DateTime.Now.AddYears(1).ToString("MMMM d, yyyy") },
        };

        // Replace placeholders in the document with actual data
        foreach (var replacement in replacements)
        {
            doc.Texts.ForEach(x => x.Replace(replacement.Key, replacement.Value));
        }

        // Save the filled document
        doc.Save(outputPath);

        // Notify the user that the document has been saved successfully
        Console.WriteLine("Document filled and saved successfully.");
    }
}

Imports System
Imports System.Collections.Generic
Imports IronWord

Friend Class Program
	Shared Sub Main()
		' Set the license key for IronWord
		License.LicenseKey = "your key"

		' Define paths for the template and the output file
		Dim templatePath As String = "Template.docx"
		Dim outputPath As String = "FilledDocument.docx"

		' Create a new instance of the WordDocument class using the template path
		Dim doc As New WordDocument(templatePath)

		' Define a dictionary of placeholders and their replacements
		Dim replacements = New Dictionary(Of String, String) From {
			{"{Name}", "John Doe"},
			{"{Date}", DateTime.Now.ToString("MMMM d, yyyy")},
			{"{Address}", "123 Iron Street, Iron Software"},
			{"{product}", "IronWord"},
			{"{Sender}", "IronSoftware"},
			{"{phone}", "+123 456789"},
			{"{email}", "sale@ironsoftware.com"},
			{"{expiryDate}", DateTime.Now.AddYears(1).ToString("MMMM d, yyyy")}
		}

		' Replace placeholders in the document with actual data
		For Each replacement In replacements
			doc.Texts.ForEach(Function(x) x.Replace(replacement.Key, replacement.Value))
		Next replacement

		' Save the filled document
		doc.Save(outputPath)

		' Notify the user that the document has been saved successfully
		Console.WriteLine("Document filled and saved successfully.")
	End Sub
End Class

Adım 5: Oluşturulan Word belgesine metin efektleri ekleyin.

IronWord ayrıca aşağıdaki tabloda gösterildiği gibi çeşitli metin efektleri eklemenize olanak tanır.

Aşağıdaki örnekte, 'IronSoftware' kelimesine metin efektleri eklenmiştir.

using System;
using System.Collections.Generic;
using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Set the license key for IronWord
        License.LicenseKey = "your key";

        // Define paths for the template and the output file
        string templatePath = "Template.docx";
        string outputPath = "glowEffect.docx";

        // Create a new instance of the WordDocument class
        WordDocument doc = new WordDocument(templatePath);

        // Define a dictionary of placeholders and their replacements
        var replacements = new Dictionary<string, string>
        {
            { "{Name}", "John Doe" },
            { "{Date}", DateTime.Now.ToString("MMMM d, yyyy") },
            { "{Address}", "123 Iron Street, Iron Software" },
            { "{product}", "IronWord" },
            { "{Sender}", "Sale," },
            { "{phone}", "+123 456789" },
            { "{email}", "sale@ironsoftware.com" },
            { "{expiryDate}", DateTime.Now.AddYears(1).ToString("MMMM d, yyyy") },
        };

        // Replace placeholders in the document with actual data
        foreach (var replacement in replacements)
        {
            doc.Texts.ForEach(x => x.Replace(replacement.Key, replacement.Value));
        }

        // Create and configure text style methods with a glow effect
        TextStyle textStyle = new TextStyle
        {
            TextEffect = new TextEffect()
            {
                GlowEffect = new Glow()
                {
                    GlowColor = IronWord.Models.Color.Aqua,
                    GlowRadius = 10,
                },
            }
        };

        // Add styled text to the document
        doc.AddText(" IronSoftware").Style = textStyle;

        // Save the document with the glow effect
        doc.SaveAs(outputPath);

        // Notify the user that the document has been saved successfully
        Console.WriteLine("Styled document saved successfully.");
    }
}

using System;
using System.Collections.Generic;
using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Set the license key for IronWord
        License.LicenseKey = "your key";

        // Define paths for the template and the output file
        string templatePath = "Template.docx";
        string outputPath = "glowEffect.docx";

        // Create a new instance of the WordDocument class
        WordDocument doc = new WordDocument(templatePath);

        // Define a dictionary of placeholders and their replacements
        var replacements = new Dictionary<string, string>
        {
            { "{Name}", "John Doe" },
            { "{Date}", DateTime.Now.ToString("MMMM d, yyyy") },
            { "{Address}", "123 Iron Street, Iron Software" },
            { "{product}", "IronWord" },
            { "{Sender}", "Sale," },
            { "{phone}", "+123 456789" },
            { "{email}", "sale@ironsoftware.com" },
            { "{expiryDate}", DateTime.Now.AddYears(1).ToString("MMMM d, yyyy") },
        };

        // Replace placeholders in the document with actual data
        foreach (var replacement in replacements)
        {
            doc.Texts.ForEach(x => x.Replace(replacement.Key, replacement.Value));
        }

        // Create and configure text style methods with a glow effect
        TextStyle textStyle = new TextStyle
        {
            TextEffect = new TextEffect()
            {
                GlowEffect = new Glow()
                {
                    GlowColor = IronWord.Models.Color.Aqua,
                    GlowRadius = 10,
                },
            }
        };

        // Add styled text to the document
        doc.AddText(" IronSoftware").Style = textStyle;

        // Save the document with the glow effect
        doc.SaveAs(outputPath);

        // Notify the user that the document has been saved successfully
        Console.WriteLine("Styled document saved successfully.");
    }
}

Imports System
Imports System.Collections.Generic
Imports IronWord
Imports IronWord.Models

Friend Class Program
	Shared Sub Main()
		' Set the license key for IronWord
		License.LicenseKey = "your key"

		' Define paths for the template and the output file
		Dim templatePath As String = "Template.docx"
		Dim outputPath As String = "glowEffect.docx"

		' Create a new instance of the WordDocument class
		Dim doc As New WordDocument(templatePath)

		' Define a dictionary of placeholders and their replacements
		Dim replacements = New Dictionary(Of String, String) From {
			{"{Name}", "John Doe"},
			{"{Date}", DateTime.Now.ToString("MMMM d, yyyy")},
			{"{Address}", "123 Iron Street, Iron Software"},
			{"{product}", "IronWord"},
			{"{Sender}", "Sale,"},
			{"{phone}", "+123 456789"},
			{"{email}", "sale@ironsoftware.com"},
			{"{expiryDate}", DateTime.Now.AddYears(1).ToString("MMMM d, yyyy")}
		}

		' Replace placeholders in the document with actual data
		For Each replacement In replacements
			doc.Texts.ForEach(Function(x) x.Replace(replacement.Key, replacement.Value))
		Next replacement

		' Create and configure text style methods with a glow effect
		Dim textStyle As New TextStyle With {
			.TextEffect = New TextEffect() With {
				.GlowEffect = New Glow() With {
					.GlowColor = IronWord.Models.Color.Aqua,
					.GlowRadius = 10
				}
			}
		}

		' Add styled text to the document
		doc.AddText(" IronSoftware").Style = textStyle

		' Save the document with the glow effect
		doc.SaveAs(outputPath)

		' Notify the user that the document has been saved successfully
		Console.WriteLine("Styled document saved successfully.")
	End Sub
End Class

Açıklama

Gözden geçirilmiş kod, IronWord kütüphanesini kullanarak bir Word belge şablonunu doldurmayı, metinleri biçimlendirmeyi ve değiştirilmiş belgeyi kaydetmeyi göstermektedir. İşte kısa bir açıklama:

1. Lisans Kurulumu: IronWord lisans anahtarını işlevsellik için ayarlar.
2. Dosya Yolları: Şablon (Template.docx) ve çıktı dosyası (glowEffect.docx) için yolları belirtir.
3. Belge Örneği Oluştur: Verilen şablon yolunu kullanarak bir WordDocument örneği başlatır.
4. Yer Tutucuları Tanımlayın: Yer tutucular ve karşılık gelen değişim değerleri içeren bir sözlük oluşturur.
5. Yer Tutucuları Değiştirin: Sözlükten geçerek belgede gerçek verilerle yer tutucuları değiştirir.
6. Metin Stili Yapılandırın: Renk ve yarıçap belirterek parıltı efekti ile bir metin stili tanımlar.
7. Stilize Metin Ekleyin: Belgeye yapılandırılmış stil ile metin ekler.
8. Belgeyi Kaydet: Uygulanan metin stilini yansıtan yeni bir adla güncellenmiş belgeyi kaydeder (glowEffect.docx).
9. Konsol Çıkışı: Stilize belgenin kaydedildiğini onaylamak için bir mesaj yazdırılır.

Çıktı

IronWord Lisanslama

IronWord. Veri girildikten sonra, lisans sağlanan e-posta ID'sine gönderilir. Bu lisans, IronWord kütüphanesini kullanmadan önce kodun başlangıcına yerleştirilmelidir.

License.LicenseKey = "your Key Here";

License.LicenseKey = "your Key Here";

License.LicenseKey = "your Key Here"

Sonuç

IronWord, şablonları kullanarak Word belgeleri üretiminde birkaç avantaj sunar. Şablonları belirli verilerle doldurma işlemini programatik olarak gerçekleştirerek, belgelerin oluşturulması otomasyonunu basitleştirir, manuel giriş ihtiyaçını azaltır. Bu, insan hatası riskinin minimize edilmesiyle verimlilik ve doğruluğu artırır. Ayrıca, IronWord belgeler arasında tutarlılığı korunmaya yardımcı olarak, her oluşturulan dosyanın aynı format ve yapıya bağlı kalmasını sağlar. Tekrarlayan görevlerin otomasyonu, belgeleri hızlı bir şekilde büyük miktarda üretmeyi ideal hale getirerek zaman ve kaynak tasarrufu sağlar. IronWord, sık veya karmaşık belge oluşturmayı gerektiren senaryolarda üretkenliği artırır ve iş akışlarını kolaylaştırır.

Bu makalede ana hatları çizilen adımları izleyerek ve sağlanan örnekten yararlanarak IronWord ile belge oluşturma ihtiyaçlarınızı verimli bir şekilde yönetebilir ve iş akışınızı basit hale getirebilirsiniz.