Şablondan Word oluşturma C#'ta

Belge oluşturma otomasyonu, dinamik raporlar, faturalar ve mektuplar oluşturmayı hedefleyen işletmeler için hayati öneme sahiptir. Aspose.Words Mail Merge for .NET ile nesneler, CSV, JSON ve XML dahil olmak üzere çeşitli kaynaklardan Word şablonlarını verilerle etkili bir şekilde doldurabilirsiniz. Bu kılavuz, C#’ta Mail Merge kullanarak belgelerinizi otomatikleştirmenize ve dinamik Word belgeleri oluşturmanıza yardımcı olacaktır.


Kapsanan Konular:


Mail Merge için .NET Genel Bakış

Aspose.Words Mail Merge for .NET, geliştiricilerin birleştirme alanları içeren önceden tanımlanmış şablonlardan kişiselleştirilmiş belgeler oluşturmasını sağlar. Bu eklenti, .NET ortamlarında sorunsuz entegrasyon için tasarlanmıştır ve aşağıdaki yetenekleri sunar:

  • Verilerle dinamik olarak şablonları doldurmak, .NET framework Word belge oluşturmayı desteklemek.
  • Büyük veri setleri için .NET mail merge çözümünü kullanarak toplu belge oluşturma işlemlerini etkin bir şekilde gerçekleştirmek.
  • Çıktılar arasında tutarlı biçimlendirmeyi sağlamak, C# Word belge şablonu en iyi uygulamalarını geliştirmek.

Ana Özellikler:

  1. Çoklu Kaynak Desteği: C# ile nesneler, veritabanları, XML, JSON ve CSV’den veri kullanarak özelleştirilmiş Word belgeleri oluşturun.
  2. Yüksek Performans: .NET Core ile dinamik Word belge oluşturma için büyük veri setlerini ve toplu işlemleri etkin bir şekilde yönetin.
  3. Özelleştirilebilir Şablonlar: Verilerin yerleştirilmesi için yer tutucularla şablonlar oluşturun, .NET Word mail merge otomasyon yeteneklerini kullanarak.

Kurulum

Başlamak için NuGet kullanarak Aspose.Words’u yükleyin:

PM> Install-Package Aspose.Words

C# Nesneleri Kullanarak Şablondan Word Belgesi Oluşturma

C# nesnelerini kullanarak bir Word şablonunu doldurarak başlayalım. Aşağıdaki yer tutucularla bir Word belgesi (DOC/DOCX) oluşturacağız:

<<[sender.Name]>> diyor ki: "<<[sender.Message]>>."

Bu örnekte, sender, şablonu doldurmak için kullanacağımız bir sınıfın örneğidir ve C# veritabanından Word belgesi oluşturma yaklaşımını kullanacağız.

Sonraki adımda, Aspose.Words‘un raporlama motorunu kullanarak şablondan ve Sender sınıfının örneğinden Word belgesini oluşturacağız. Aşağıdaki adımları izleyin:

  1. Document sınıfının bir örneğini oluşturun ve Word şablonunun yoluyla başlatın.
  2. Sender sınıfının bir örneğini oluşturun ve başlatın.
  3. ReportingEngine sınıfını başlatın.
  4. ReportingEngine.BuildReport() yöntemini kullanarak şablonu doldurun; bu yöntem, Document’ın örneğini, veri kaynağını ve veri kaynağının adını parametre olarak alır.
  5. Oluşturulan Word belgesini Document.Save() yöntemini kullanarak kaydedin.

C#’ta şablondan bir Word belgesi oluşturma işlemini gösteren kod örneği burada.

Çıktı

XML Veri Kaynağından C#’ta Word Belgesi Oluşturma

XML veri kaynağından bir Word belgesi oluşturmak için, aşağıdaki yer tutucularla daha karmaşık bir Word şablonu kullanacağız:

<<foreach [in persons]>>İsim: <<[Name]>>, Yaş: <<[Age]>>, Doğum Tarihi: <<[Birth]:"dd.MM.yyyy">>
<</foreach>>
Ortalama yaş: <<[persons.Average(p => p.Age)]>>

Bu örnekte kullanılan XML veri kaynağı aşağıda gösterilmiştir.

XML veri kaynağından bir Word belgesi oluşturmak için aşağıdaki adımları izleyin:

  1. Document sınıfının bir örneğini oluşturun ve Word şablonunun yoluyla başlatın.
  2. XmlDataSource sınıfının bir örneğini oluşturun ve XML dosyasının yoluyla başlatın.
  3. ReportingEngine sınıfını başlatın.
  4. Word şablonunu doldurmak için ReportingEngine.BuildReport() yöntemini kullanın.
  5. Oluşturulan Word belgesini Document.Save() yöntemini kullanarak kaydedin.

C#’ta XML veri kaynağından bir Word belgesi oluşturma işlemini gösteren kod örneği burada.

Çıktı

JSON Veri Kaynağından C#’ta Word Belgesi Oluşturma

Sonraki adımda, bir JSON veri kaynağı kullanarak bir Word belgesi oluşturmayı keşfedelim. Bu örnekte, yöneticilerine göre sınıflandırılmış bir müşteri listesi oluşturacağız. Word şablonu şöyle görünecek:

<<foreach [in managers]>>Yönetici: <<[Name]>>
Sözleşmeler:
<<foreach [in Contract]>>- <<[Client.Name]>> ($<<[Price]>>)
<</foreach>>
<</foreach>>

Şablonu doldurmak için kullanacağımız JSON veri kaynağı aşağıdadır:

JSON’dan Word belgesini oluşturmak için JsonDataSource sınıfını kullanarak veri kaynağını yükleyeceğiz ve geri kalan adımlar önceki yapıyı takip edecektir. C#’ta JSON şablonundan bir Word belgesi oluşturma işlemini gösteren kod örneği burada.

Çıktı

CSV Veri Kaynağından C#’ta Word Belgesi Oluşturma

CSV kaynağından Word belgesini oluşturmak için aşağıdaki Word şablonunu kullanacağız:

<<foreach [in persons]>>İsim: <<[Column1]>>, Yaş: <<[Column2]>>, Doğum Tarihi: <<[Column3]:"dd.MM.yyyy">>
<</foreach>>
Ortalama yaş: <<[persons.Average(p => p.Column2)]>>

Şablon, aşağıdaki CSV verileri kullanılarak doldurulacaktır:

Şimdi C# kodunu gözden geçirelim. Adımlar aynı kalır, tek bir önemli farkla: CSV verilerini yüklemek için CsvDataSource sınıfını kullanacağız. Aşağıdaki kod örneği, CSV veri kaynağından Word belgesi oluşturma işlemini göstermektedir.

Çıktı

Aspose.Words for .NET’i Ücretsiz Deneyin

Aspose.Words for .NET‘i ücretsiz bir geçici lisans kullanarak deneyebilirsiniz.

Sonuç

Bu makalede, C# kullanarak şablonlardan Word belgeleri oluşturmayı öğrendiniz. Nesneler, XML, JSON ve CSV gibi çeşitli veri kaynaklarını .NET’te dinamik belge oluşturma için nasıl kullanacağınızı keşfettiniz. .NET Word şablon işleme yetenekleri hakkında daha fazla bilgi için belgelere göz atın ve lütfen forumumuzdan bize ulaşın.

Ayrıca Bakınız