Kişiselleştirilmiş belgelerin oluşturulmasını otomatikleştirmek – örneğin raporlar, mektuplar ve faturalar – çalışma akışınızın verimliliğini önemli ölçüde arttırabilir. C# Mail Merge ile Aspose.Words for .NET tarafından güçlendirilir, bunu kolaylıkla elde edebilirsiniz. bu kılavuz, verimli ve ölçeklenebilir bir belge üretimi gerçekleştirmek için Plugin’i kullanarak size yol açacaktır. Message C# fonksiyonu kullanılarak raporlama çalışkanızı entegre etmek için donatılmış olacaksınız.
içeriği
- Mail Merge Nedir ?
- Mail Merge için veri kaynağı
- Mail Merge Şablonları Hazırlama
- .NET için Aspose.Words ile başlamak
- Göre Göre Göre Göre Göre Göre Göre
- E-posta XML verileriyle birleşir
- Özelleştirilmiş Birleşme Alanı Formatı
- Mektuplar Bölgelerle Birleşiyor
- Nested Mail Birleşti
- Sonuç
Mail Merge Nedir? / Mail Merge Nedir?
Mail Merge, çeşitli kaynaklardan gelen verilerle şablonları nüfuz ederek dinamik olarak belgeleri oluşturmak için güçlü bir metodolojidir. Aspose.Words ile aşağıdaki gibi görevleri otomatik hale getirebilirsiniz:
- Kişiselleştirilmiş mektuplar ve faturalar oluşturulur.
- XML, JSON veya veritabanları gibi yapılandırılmış biçimleri kullanarak toplu raporlar oluşturmak, C# ve Aspose.Words** ile **dinamik rapor üretimi sağlar.
Mail Merge için veri kaynakları
Aspose.Words çeşitli veri kaynaklarını destekler, şunları da içerir:
- Objects: Sınıf örneklerini kullanarak popüler şablonlar.
- XML: Dinamik alanlar için yapılandırılmış verileri yükleyin.
- JSON: Modern APIs ile kolayca entegre edilir.
- CSV: Bulk belge üretimi için tablo verilerini kaldırın.
- DataTable/DataSet: Veritabanı entegrasyonu için ADO.NET kullanın.
Mail Merge için Şablon Hazırlama
E-posta birleştirme şablonu, uygulama sırasında belirtilen veri kaynağınızdan gelen verilerle nüfuz edilecek birleştirme alanları içeren bir belgedir. şablon DOC veya DOCX biçiminde olabilir ve belirli bir tarz gerektirmez. birleştirme şablonu oluşturmak için bu adımları izleyin:
- Belgenizi açın veya MS Word’de yeni bir belge oluşturun.
- Birleşme alanı yerleştirmek istediğiniz yerde kursörü yerleştirin.
- Giriş menüsünden Kaynak seçeneğini seçin.
- Feld isimleri listesinden MergeField seçeneğini seçin.
- Birleşme alanı için bir isim belirleyin Araç adı kutusunda ve OK tıklatın.
- Belgeyi saklayın
Aşağıdaki ekran görüntüsü bir Örnek Şablon Bu belge.

.NET Mail Merge API - Yükleme
Aspose.Words for .NET çeşitli yöntemlerle yüklenebilir:
C# kullanılarak Word Belgesinde Mail Birleşmeyi gerçekleştirin
Şablonunuz hazır olduğunda, belgeleri oluşturmak için e-posta birleşimini çalıştırabilirsiniz. burada hazırlanmış şablonunuzda e-posta birleşimini gerçekleştirmek için adımlar:
- Şablonu kullanarak dosyayı yükleme belge Sınıfı
- İhtiyacınız olan e-posta kombinasyon seçenekleri, örneğin Doküman.MailMerge.TrimWhitespaces.
- e-posta birleştirme kullanarak gerçekleştirin Etiket Arşivi: MailMerge.Execute() Metoda, veri kaynağını bir parametre olarak geçirir.
- oluşturulan belgeyi kullanarak kaydedin Etiket Arşivi: String Yöntemleri
İşte bir kod örneği, bir dizi değer kullanarak C#‘da otomatik raporlama üretimi nasıl gösterilir:
E-posta Birleştikten Sonra Yazı Belgeleri

C#‘da XML veri kaynağını kullanarak Mail Merge’i gerçekleştirin
XML dosyaları genellikle veri depolamak ve aktarmak için kullanılır. Aspose.Words için .NET, e-posta birleştirme işlemleri için bir veri kaynağı olarak XML’i destekler. DataSet aşağıda örnek XML dosyası bizim kullanım durumumuz için.
<customers>
<customer Name="John Ben Jan" ID="1" Domain="History" City="Boston"/>
<customer Name="Lisa Lane" ID="2" Domain="Chemistry" City="LA"/>
<customer Name="Dagomir Zits" ID="3" Domain="Heraldry" City="Milwaukee"/>
<customer Name="Sara Careira Santy" ID="4" Domain="IT" City="Miami"/>
</customers>
Aşağıdaki kod örneği, bir XML veri kaynağından verileri alır ve C# kullanılarak e-posta birleşmesini gerçekleştirir.
Aşağıda e-posta birleştirme Tapınağı XML dosyasından gelen verilerle popülasyon yapılacaktır.

Bu görüntü, e-posta birleşmesini gerçekleştirdikten sonra elde edilen sonuçlanan Word belgesinin ilk sayfasını temsil eder.

Birleşme alanlarının özelleştirilmiş biçimlendirmesi
Aspose.Words .NET için e-posta birleşme sürecinin kontrolünü arttırır. MailMerge.FieldMergingCallback İletişim Mülkiyet, e-posta birleştirme davranışını her bir birleşme alanı karşılaştığı gibi ayarlamayı sağlar. iFieldMergingCallback.FieldMerging İletişim ve iFieldMergingCallback.ImageFieldMerging Bu yöntemler, e-posta birleşme işlemi özelleştirilmesini sağlar.
Aşağıda, e-posta birleştirme sırasında özelleştirilmiş biçimlendirme nasıl uygulanacağını gösteren bir kod örneği sağlanan örnek şablonu aracılığıyla:
Aşağıda HandleMergeFieldAlternatingRows sınıfı uygulanır.
Mail Birleşme Bölgeler ile C# kullanarak
Bazı durumlarda, kelime belgesinde belirli bir bölgeyi nüfuz etmeniz ve tekrarlamanız gerekebilir. Bu tür senaryolar için, bölgelerle e-posta birleşmesini kullanın. Bölge oluşturmak için hem bölgenin başlangıcını hem de sonunu belirtin; posta birleştirme daha sonra veri kaynağındaki her kayıt için bu bölgesi tekrarlayacaktır. Aşağıdaki şablon örneği, “TableStart:OrderDetails” alanlarını kullanarak iki bölüm içerir.

İşte yukarıda bahsedilen bölgelere göre e-posta birleşmesini gerçekleştiren bir kod örneği Tapınağı.
Aşağıdaki yöntemler, bir verilerin bir veritabanından nasıl okunabileceğini gösterir.
NESTED MAIL MERGE İÇİN TIKLAYIN
Çoğu zaman, kaynaktan gelen veriler ilişkisel biçimlerde yapılandırılır. Örneğin, “Hesaplar” bir sipariş içindeki öğelerin kayıtlarını tutan “Kayıt Detayları” ile bir-birinden bir ilişkiye sahip olabilir. Fatura Şablonu Bu senaryo çok iyi uyuyor.

Aşağıda, kaydedilen e-posta birleştirme örneğimiz için bir XML veri kaynağıdır.
<?xml version="1.0" encoding ="utf-8"?>
<Orders xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="OrdersSchema.xsd">
<Order>
<Number>23</Number>
<Address>Nelson Street</Address>
<Suburb>Howick</Suburb>
<City>Auckland</City>
<Phonenumber>543 1234</Phonenumber>
<Date>03/01/2010</Date>
<Total>14.00</Total>
<Item>
<Name>BBQ Chicken Pizza</Name>
<Price>6.00</Price>
<Quantity>1</Quantity>
<ItemTotal>6.00</ItemTotal>
</Item>
<Item>
<Name>1.5 Litre Coke</Name>
<Price>4.00</Price>
<Quantity>2</Quantity>
<ItemTotal>8.00</ItemTotal>
</Item>
</Order>
<Order>
<Number>10</Number>
<Address>Parkville Avenue</Address>
<Suburb>Pakuranga</Suburb>
<City>Auckland</City>
<Phonenumber>548 7342</Phonenumber>
<Date>05/03/2010</Date>
<Total>6.00</Total>
<Item>
<Name>Hawaiian Pizza</Name>
<Price>4.00</Price>
<Quantity>1</Quantity>
<ItemTotal>4.00</ItemTotal>
</Item>
<Item>
<Name>Fries</Name>
<Price>1.00</Price>
<Quantity>2</Quantity>
<ItemTotal>2.00</ItemTotal>
</Item>
</Order>
</Orders>
Bu XML için OrderSchema.xsd dosyası şunlardır:
<?xml version="1.0" encoding ="utf-8"?>
<xs:schema id="OrdersSchema" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="Orders">
<xs:complexType>
<xs:sequence>
<xs:element name="Order">
<xs:complexType>
<xs:sequence>
<xs:element name="Number"/>
<xs:element name="Address"/>
<xs:element name="Suburb"/>
<xs:element name="City"/>
<xs:element name="Phonenumber"/>
<xs:element name="Date"/>
<xs:element name="Total"/>
<xs:element name="Item">
<xs:complexType>
<xs:sequence>
<xs:element name="Name"/>
<xs:element name="Price"/>
<xs:element name="Quantity"/>
<xs:element name="ItemTotal"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
Aşağıdaki kod örneği, C# kullanılarak nakit e-posta birleşimini gerçekleştirir.
E-posta Birleştikten Sonra Yazı Belgeleri
Aşağıda, kaydedilen e-posta birleşimini gerçekleştirdikten sonra elde edilen sonuçlanan Word belgesinin ilk sayfasını görüyoruz.

Sonuç
Aspose.Words için .NET hem standart hem de genişletilmiş özellikler sağlayan kapsamlı bir e-posta birleştirme API. sadece birkaç kod çizgisi ile, çeşitli veri kaynaklarından basit veya karmaşık raporlar geliştirebilirsiniz. .NET otomatik rapor oluşturma en iyi uygulamaları hakkında rehberlik için, lütfen Dokümanlık.NET için Aspose.Words ile başlamak için, mevcut olanı keşfedin Geliştirici Rehberi Örnek kodu üzerinde GitHub. Aspose Plugin ayrıca rapor oluşturma için gelişmiş fonksiyonlar sunar.
Aspose.Words için .NET için Ücretsiz
Sınırlamalar olmadan .NET için Aspose.Words denemek için ücretsiz bir geçici lisans elde edebilirsiniz. Şimdi geçici lisansınızı alın.
More in this category
- Word DOC/DOCX'i PDF'ye C# .NET ve Aspose.Words' Document Converter Plugin'e dönüştürün
- Word Belgelerinde Barkod Oluşturma (.NET, C#) | Word'den Barkod Okuma (.NET)
- Word Belgelerinden Görüntüleri Çekme C# Otomatik Görüntüleme İşleme
- C# ile Word belgelerinde metin bulmak ve değiştirmek
- C# .NET Aspose.Words Mail Plugin'i kullanarak özelleştirilmiş Word belgeleri oluşturun