How to Mail Merge Word Documents in C

Bir Sözlükten E-posta Birleştirmesini Nasıl Yaparım?

En basit veri kaynağı birleşim alanı adlarına göre anahtarlanmış bir IDictionary<string, string>'dır. Execute adı bir anahtarla eşleşen her alanı değiştirir.

WordDocument doc = new WordDocument("template.docx");
doc.MailMerge.Execute(new Dictionary<string, string>
{
    { "FirstName", "Jane" },
    { "LastName",  "Smith" },
    { "Company",   "Acme Corp" }
});
doc.SaveAs("output.docx");

WordDocument doc = new WordDocument("template.docx");
doc.MailMerge.Execute(new Dictionary<string, string>
{
    { "FirstName", "Jane" },
    { "LastName",  "Smith" },
    { "Company",   "Acme Corp" }
});
doc.SaveAs("output.docx");

Dim doc As New WordDocument("template.docx")
doc.MailMerge.Execute(New Dictionary(Of String, String) From {
    {"FirstName", "Jane"},
    {"LastName", "Smith"},
    {"Company", "Acme Corp"}
})
doc.SaveAs("output.docx")

Ayrıca, alan adları ve değerlerinden oluşan iki paralel dizi sağlayabilirsiniz:

doc.MailMerge.Execute(
    new[] { "FirstName", "LastName" },
    new[] { "Jane", "Smith" });

doc.MailMerge.Execute(
    new[] { "FirstName", "LastName" },
    new[] { "Jane", "Smith" });

doc.MailMerge.Execute(  
    New String() { "FirstName", "LastName" },  
    New String() { "Jane", "Smith" })

Execute(fieldNames, values), iki dizi farklı uzunluklardaysa bir ArgumentException atar.

Bir DataTable veya DataRow'dan E-posta Birleştirmesini Nasıl Yaparım?

Veriler bir veritabanından veya mevcut bir DataSet'den geldiğinde, bir DataTable veya DataRow doğrudan Execute'a aktarın. Birleştirme alanı adları sütun adları ile eşleştirilir. Execute(DataTable), tablonun ilk satırındaki değerleri kullanırken, Execute(DataRow) satırın üst tablo adlarını kullanır.

DataTable table = new DataTable();
table.Columns.Add("FirstName");
table.Columns.Add("LastName");
DataRow row = table.NewRow();
row["FirstName"] = "Jane";
row["LastName"]  = "Smith";
table.Rows.Add(row);

WordDocument doc = new WordDocument("template.docx");
doc.MailMerge.Execute(row);
doc.SaveAs("output.docx");

DataTable table = new DataTable();
table.Columns.Add("FirstName");
table.Columns.Add("LastName");
DataRow row = table.NewRow();
row["FirstName"] = "Jane";
row["LastName"]  = "Smith";
table.Rows.Add(row);

WordDocument doc = new WordDocument("template.docx");
doc.MailMerge.Execute(row);
doc.SaveAs("output.docx");

Imports System.Data

Dim table As New DataTable()
table.Columns.Add("FirstName")
table.Columns.Add("LastName")
Dim row As DataRow = table.NewRow()
row("FirstName") = "Jane"
row("LastName") = "Smith"
table.Rows.Add(row)

Dim doc As New WordDocument("template.docx")
doc.MailMerge.Execute(row)
doc.SaveAs("output.docx")

Tekrar Eden Tablo Bölgelerini Nasıl Doldururum?

Tekrar eden bölgeler, bir şablon satırını birden fazla satıra dönüştürür, bu da fatura hat öğeleri veya sipariş listeleri için idealdir. Şablonda, tekrarlanan içeriği TableStart:RegionName ve TableEnd:RegionName adındaki iki işaret alanı arasına almaya çalışın. Daha sonra, eşleşen tablonun her satırı için bir defa bölgenin içeriğini tekrarlayan ExecuteWithRegions'ı çağırın.

ExecuteWithRegions, tam bir DataSet (adı bir tabloyla eşleşen her bölgeyi genişletir), tek bir DataTable (adı dataTable.TableName ile eşleşen bölgeyi genişletir) veya bir DataTable ile birlikte bir bölge adı kabul eder.

DataTable orders = new DataTable("Orders");
orders.Columns.Add("Item");
orders.Columns.Add("Qty");
orders.Rows.Add("Widget A", "3");
orders.Rows.Add("Widget B", "1");

DataSet ds = new DataSet();
ds.Tables.Add(orders);

WordDocument doc = new WordDocument("invoice-template.docx");
doc.MailMerge.ExecuteWithRegions(ds);
doc.MailMerge.Execute(new Dictionary<string, string> { { "CustomerName", "Jane Smith" } });
doc.SaveAs("invoice.docx");

DataTable orders = new DataTable("Orders");
orders.Columns.Add("Item");
orders.Columns.Add("Qty");
orders.Rows.Add("Widget A", "3");
orders.Rows.Add("Widget B", "1");

DataSet ds = new DataSet();
ds.Tables.Add(orders);

WordDocument doc = new WordDocument("invoice-template.docx");
doc.MailMerge.ExecuteWithRegions(ds);
doc.MailMerge.Execute(new Dictionary<string, string> { { "CustomerName", "Jane Smith" } });
doc.SaveAs("invoice.docx");

Imports System.Data
Imports System.Collections.Generic

Dim orders As New DataTable("Orders")
orders.Columns.Add("Item")
orders.Columns.Add("Qty")
orders.Rows.Add("Widget A", "3")
orders.Rows.Add("Widget B", "1")

Dim ds As New DataSet()
ds.Tables.Add(orders)

Dim doc As New WordDocument("invoice-template.docx")
doc.MailMerge.ExecuteWithRegions(ds)
doc.MailMerge.Execute(New Dictionary(Of String, String) From {{"CustomerName", "Jane Smith"}})
doc.SaveAs("invoice.docx")

[(i:(ExecuteWithRegions yalnızca tekrarlanan bölgeleri doldurur. Bölgelerin dışında standart birleşim alanlarını da doldurmak için, yukarıda gösterildiği gibi bölgeleri genişlettikten sonra Execute(...)'i çağırın.)}]

Bir Şablonun Birleştirme Alanlarını Nasıl İncelerim?

Birleştirmeden önce, bir şablonun neler içerdiğini keşfedebilir, bu da şablonları doğrulamak veya veri kaynağını dinamik olarak oluşturmak için faydalıdır.

• GetFieldNames(), belgede sıralı ve tekrarlanmamış tüm değer-stili birleşim alanlarının adlarını geri döndürür.
• GetRegionNames(), belgede bildirilen tüm TableStart bölgelerinin adlarını geri döndürür.
• GetFields(), TableEnd işaretçileri de dahil olmak üzere her alanı MergeField nesneleri olarak geri döndürür.

WordDocument doc = new WordDocument("template.docx");
IReadOnlyList<string> fieldNames = doc.MailMerge.GetFieldNames();
IReadOnlyList<string> regionNames = doc.MailMerge.GetRegionNames();
// fieldNames:  ["FirstName", "LastName", "Company"]
// regionNames: ["Orders", "LineItems"]

WordDocument doc = new WordDocument("template.docx");
IReadOnlyList<string> fieldNames = doc.MailMerge.GetFieldNames();
IReadOnlyList<string> regionNames = doc.MailMerge.GetRegionNames();
// fieldNames:  ["FirstName", "LastName", "Company"]
// regionNames: ["Orders", "LineItems"]

Dim doc As New WordDocument("template.docx")
Dim fieldNames As IReadOnlyList(Of String) = doc.MailMerge.GetFieldNames()
Dim regionNames As IReadOnlyList(Of String) = doc.MailMerge.GetRegionNames()
' fieldNames:  ["FirstName", "LastName", "Company"]
' regionNames: ["Orders", "LineItems"]

Her MergeField, Name'sunu, belgede saklandığı haliyle tam Instruction metnini (örneğin MERGEFIELD FirstName \* MERGEFORMAT), yalnızca bölge işaretçileri için ayarlanan bir RegionName (örneğin "Orders", "TableStart:Orders"'den) ve alanı Value (veri değeri ile değiştirilen metin), TableStart 'ye veya TableEnd 'ye sınıflandıran bir Kind (tekrarlanan bir bölge sınırları) veya NextRecord (aynı şablon gövdesi içinde bir sonraki veri kaydına ilerleyen bir NEXT alanı) açar.

Eşleşmemiş Alanları ve Null Değerlerini Nasıl Kontrol Edebilirim?

Birleştirme davranışı MailMerge.Options aracılığıyla yapılandırılır:

WordDocument doc = new WordDocument("template.docx");
doc.MailMerge.Options.RemoveUnusedFields = false;
doc.MailMerge.Execute(new Dictionary<string, string> { { "FirstName", "Jane" } });
doc.SaveAs("partial-output.docx");

WordDocument doc = new WordDocument("template.docx");
doc.MailMerge.Options.RemoveUnusedFields = false;
doc.MailMerge.Execute(new Dictionary<string, string> { { "FirstName", "Jane" } });
doc.SaveAs("partial-output.docx");

Dim doc As New WordDocument("template.docx")
doc.MailMerge.Options.RemoveUnusedFields = False
doc.MailMerge.Execute(New Dictionary(Of String, String) From {{"FirstName", "Jane"}})
doc.SaveAs("partial-output.docx")

Basit değer yerine koyma işlemini bir veri kaynağı olmadan yapmak istiyorsanız, bir Word belgesinde metni nasıl değiştireceğinizi görmek için tıklayın.