IronWord Kullanarak C#'da Word Belgelerine Filigran Ekleme

C#'te Word Şablon Kullanarak Bir Word Belgesi Nasıl Üretilir?

1. Microsoft Visual Studio'da yeni bir proje oluşturun.
2. NuGet paket yöneticisi aracılığıyla IronWord'u kurun.
3. Bir Word Şablon belgesi oluşturun.
4. Bir Word belgesine veri ekleyin ve yeni bir dosya olarak kaydedin.
5. Üretilen Word belgesine metin efektleri ekleyin.

IronWord nedir?

IronWord, Iron Software tarafından sunulan, programlı olarak Microsoft Word belgeleri oluşturma, manipüle etme ve yönetmeyi kolaylaştırmak için tasarlanmış bir .NET kütüphanesidir. Geliştiricilerin, Word belgeleri üretimini otomatikleştirmesine olanak tanır, bu da raporlar, faturalar, mektuplar ve uygulamaları içinde diğer belge türlerini dinamik olarak oluşturmalarını kolaylaştırır.

Gereksinimler

Başlamadan önce sahip olmanız gerekenleri hatırlatmak istiyoruz:

Makinenize Visual Studio yüklendi.

• En son .NET Framework yüklü 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.

Destek ile mümkünse en son olan .NET Sürümünü seçin ve Oluştur'a tıklayın.

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

Aşağıda Visual Studio'da gösterildiği gibi NuGet paket yöneticisinden IronWord NuGet paketini yükleyin.

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

dotnet add package IronWord --version 2024.9.1

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

Şimdi, Word belgesi oluşturma sürecinde kullanılmak üzere bir veya iki sayfalık bir 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 eklemeye olanak tanır.

Aşağıdaki örnekte, "Iron Software" kelimesine metin efektleri ekliyoruz.

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 şablonu doldurmayı, metni biçimlendirmeyi ve değiştirilmiş belgeyi kaydetmeyi gösterir. İşte kısa bir açıklama:

1. Lisans Kurulumu: IronWord lisans anahtarı, işlevselliği etkinleştirmek için ayarlanır.
2. Dosya Yolları: Şablon (Template.docx) ve çıktı dosyası (glowEffect.docx) için yolları belirtir.
3. Belge Örneği Oluştur: Sağlanan şablon yolu kullanılarak bir WordDocument örneği başlatır.
4. Değişiklikleri Tanımlama: Yer tutucular ve bunların karşılık gelen değiştirme değerlerinden oluşan bir sözlük oluşturulur.
5. Yer Tutucuları Değiştir: Sözlükte gezinerek yer tutucuların belge içinde gerçek veri ile değiştirilmesini sağlar.
6. Metin Stilini Yapılandırın: Renk ve yarıçap belirterek parıltı efektli bir metin stili tanımlar.
7. Stil Verilen Metni Ekle: Belgeye yapılandırılmış stille metin ekler.
8. Belgeyi Kaydet: Uygulanan metin stilini yansıtarak güncellenmiş belgeyi yeni bir isimle (glowEffect.docx) kaydeder.
9. Konsol Çıkışı: Stil verilen belgenin kaydedildiğini onaylayan bir mesaj yazdırılır.

Çıktı

IronWord Lisanslama

IronWord. Veriler girildikten sonra lisans, sağlanan e-posta kimliğine gönderilir. Bu lisansın, aşağıda gösterildiği gibi IronWord kütüphanesini kullanmadan önce kodun başına yerleştirilmesi gereklidir.

License.LicenseKey = "your Key Here";

License.LicenseKey = "your Key Here";

License.LicenseKey = "your Key Here"

Sonuç

IronWord, şablonlar kullanarak Word belgeleri oluşturmak için birçok avantaj sunar. Bu, geliştiricilerin belirli verilerle şablonları programatik olarak doldurmasına olanak tanıyarak belge oluşturmayı otomatikleştirir, manuel giriş gereksinimini azaltır. Bu, insan hatası riskini en aza indirerek verimliliği ve doğruluğu artırır. Ayrıca, IronWord, belgeler arasında tutarlılığı korumaya yardımcı olur, her oluşturulan dosyanın aynı format ve yapıya uygun olmasını sağlar. Tekrarlayan görevleri otomatikleştirmek zamandan ve kaynaklardan tasarruf sağlar, bu durum büyük hacimde belgeler hızla üretmek için idealdir. IronWord, sık veya karmaşık belge oluşturma gerektiren senaryolarda verimliliği artırır ve iş akışlarını streamlined eder.

Bu makalede belirtilen adımları takip ederek ve sağlanan örneği IronWord ile kullanarak belge oluşturma ihtiyaçlarınızı verimli bir şekilde yönetebilir ve iş akışınızı streamlined edebilirsiniz.