TX Text Control 中的郵件合并 類是一個強大的庫，旨在通過將數(shù)據(jù)合并到模板中來自動創(chuàng)建文檔。它充當結(jié)構(gòu)化數(shù)據(jù)（例如來自數(shù)據(jù)庫、JSON 或 XML）和動態(tài)文檔生成之間的橋梁，對于需要自動化文檔工作流程的應(yīng)用程序來說非常有用。

從本質(zhì)上講，MailMerge 類簡化了創(chuàng)建專業(yè)、數(shù)據(jù)驅(qū)動文檔的復雜任務(wù)，允許開發(fā)人員輕松地將模板中的字段與數(shù)據(jù)源合并。模板是使用 TX Text Control 文字處理界面設(shè)計的，合并字段代表動態(tài)內(nèi)容。

TX Text Control 是一款功能類似于 MS Word 的文字處理控件，包括文檔創(chuàng)建、編輯、打印、郵件合并、格式轉(zhuǎn)換、拆分合并、導入導出、批量生成等功能。廣泛應(yīng)用于企業(yè)文檔管理，網(wǎng)站內(nèi)容發(fā)布，電子病歷中病案模板創(chuàng)建、病歷書寫、修改歷史、連續(xù)打印、病案歸檔等功能的實現(xiàn)。

TX Text Control 最新下載   

合并區(qū)塊

合并塊是 TX Text Control 的 MailMerge 類中的一個關(guān)鍵概念，它允許在文檔中動態(tài)生成結(jié)構(gòu)化、可重復的內(nèi)容。合并塊允許開發(fā)人員有效地處理模板中的重復數(shù)據(jù)結(jié)構(gòu)，例如列表、表格或嵌套區(qū)域。

從高層次上講，合并塊是模板中定義的部分，對應(yīng)于數(shù)據(jù)集合或數(shù)據(jù)表。在合并過程中，MailMerge 會遍歷數(shù)據(jù)源，動態(tài)創(chuàng)建每條記錄的內(nèi)容。這些合并塊可以使用 MailMerge 類的現(xiàn)成功能進行有條件的呈現(xiàn)、過濾和排序。

代碼級操作

但是 MailMerge 類還允許在合并過程中進行非常詳細的代碼級操作。這包括處理合并事件、自定義合并過程以及以編程方式控制合并操作的輸出。這種級別的控制對于需要對合并過程進行細粒度控制的復雜文檔生成場景至關(guān)重要。

本文介紹如何使用“字段合并” 事件來操作合并字段位于表格單元格內(nèi)時由事件返回的表格單元格。在本例中，我們將使用一個非常簡單的模板，該模板由兩個合并字段和一個用紅色突出顯示的簡單重復塊組成。

為了合并模板，我們將使用以下簡化的 JSON 數(shù)據(jù)。

[
{
"invoice-id": "1",
"invoice-date": "2019-01-01",
"line-items": [
{
"product-id": "1",
"quantity": "1",
"unit-price": "8"
},
{
"product-id": "2",
"quantity": "2",
"unit-price": "200"
},
{
"product-id": "3",
"quantity": "1",
"unit-price": "100"
},
{
"product-id": "4",
"quantity": "1",
"unit-price": "3"
}
]
}
]

為了合并此模板，將使用以下代碼：

textControl1.Load("template.tx", TXTextControl.StreamType.InternalUnicodeFormat);

MailMerge mailMerge = new MailMerge();
mailMerge.TextComponent = textControl1;

string jsonData = File.ReadAllText("data.json");
mailMerge.MergeJsonData(jsonData);

合并后的文檔結(jié)果如下：

FieldMerged 事件

現(xiàn)在讓我們附加 FieldMerged 事件來操作合并過程。

textControl1.Load("template.tx", TXTextControl.StreamType.InternalUnicodeFormat);

MailMerge mailMerge = new MailMerge();
mailMerge.TextComponent = textControl1;
mailMerge.FieldMerged += MailMerge_FieldMerged;

string jsonData = File.ReadAllText("data.json");
mailMerge.MergeJsonData(jsonData);

每次合并字段時（成功或失敗），都會調(diào)用此事件。如果字段位于表格單元格內(nèi)，則返回表格單元格。

在此事件中，我們檢查TableCell屬性是否不為空。如果不為空，我們將設(shè)置單元格的背景顏色。

private void MailMerge_FieldMerged(object sender, MailMerge.FieldMergedEventArgs e)
{
if (e.TableCell != null)
{
e.TableCell.CellFormat.BackColor = Color.Red;
e.TableCell.CellFormat.BottomBorderWidth = 60;
e.TableCell.CellFormat.BottomBorderColor = Color.Blue;
}

因此，合并過程中所有合并的單元格都會被著色。

動態(tài)單元格顏色

讓我們通過添加一些邏輯使這個過程動態(tài)化。CellFilterInstructions類用于將一個值與給定值進行比較以返回特定的顏色。

using System;
using System.Drawing;
using System.Linq;

public class CellFilterInstructions
{
public double? CompareValue { get; set; } = null;
public RelationalOperator? Operator { get; set; } = null;
public Color TrueColor { get; set; } = Color.White;
public Color FalseColor { get; set; } = Color.White;

public enum RelationalOperator
{
Equals = 0,
NotEqual,
LessThan,
GreaterThan,
}

// evaluates the instruction and returns the proper color
public Color? GetColor(string value)
{
if (Double.TryParse(ParseToNumber(value), out double dValue) == true)
{
switch (Operator)
{
case RelationalOperator.Equals:
return (dValue == CompareValue ? TrueColor : FalseColor);
case RelationalOperator.NotEqual:
return (dValue != CompareValue ? TrueColor : FalseColor);
case RelationalOperator.GreaterThan:
return (dValue > CompareValue ? TrueColor : FalseColor);
case RelationalOperator.LessThan:
return (dValue < CompareValue ? TrueColor : FalseColor);
default:
return null;
}
}
else
return null;

}

private string ParseToNumber(string text)
{
var numericChars = "0123456789,.".ToCharArray();
return new String(text.Where(c => numericChars.Any(n => n == c)).ToArray());
}
}

以下代碼創(chuàng)建了一條新規(guī)則，如果值大于 10，則返回綠色，如果值小于 10，則返回紅色。此規(guī)則被序列化并存儲在表單元格的Name屬性中。

textControl1.Load("template.tx", TXTextControl.StreamType.InternalUnicodeFormat);

CellFilterInstructions cellFilterInstructions = new CellFilterInstructions() {
CompareValue = 10,
Operator = CellFilterInstructions.RelationalOperator.GreaterThan,
TrueColor = Color.Green,
FalseColor = Color.Red
};

textControl1.Tables[1].Cells[2,2].Name =
JsonConvert.SerializeObject(cellFilterInstructions);

MailMerge mailMerge = new MailMerge();
mailMerge.TextComponent = textControl1;
mailMerge.FieldMerged += MailMerge_FieldMerged;

string jsonData = File.ReadAllText("data.json");
mailMerge.MergeJsonData(jsonData);

在FieldMerged事件中，此規(guī)則被放棄并評估。然后，返回的顏色將應(yīng)用于表格單元格的表格單元格格式。

private void MailMerge_FieldMerged(object sender, MailMerge.FieldMergedEventArgs e)
{
// custom field handling
if (e.TableCell == null)
return;

if (e.TableCell.Name != "")
{
CellFilterInstructions instructions =
(CellFilterInstructions)JsonConvert.DeserializeObject(
e.TableCell.Name,
typeof(CellFilterInstructions));

// retrieve the color
Color? color = instructions.GetColor(e.MailMergeFieldAdapter.ApplicationField.Text);

// apply the color
if (color != null)
e.TableCell.CellFormat.BackColor = (Color)color;
}
}

以下屏幕截圖顯示了此合并過程的結(jié)果：

結(jié)論

TX Text Control 中的 MailMerge 類為自動化文檔生成過程提供了強大而靈活的解決方案。使用合并塊和代碼級操作，開發(fā)人員可以輕松創(chuàng)建動態(tài)、數(shù)據(jù)驅(qū)動的文檔。FieldMerged 事件對合并過程提供了細粒度的控制，允許開發(fā)人員根據(jù)特定條件自定義輸出。這種級別的控制對于需要精確處理數(shù)據(jù)和內(nèi)容的復雜文檔生成場景至關(guān)重要。

歡迎下載|體驗更多TX Text Control產(chǎn)品