Vložení Checkboxes, zadávání textu nebo obrázků
Slučovací modul vezme dokument jako vstup, vyhledá v něm pole MERGEFIELD
a nahradí je daty získanými ze zdroje dat. Obvykle se vkládají prostý text a HTML, ale Uživatelé Aspose.Words mohou také vygenerovat dokument, který zpracovává neobvyklejší scénáře pro pole Mail Merge.
Výkonná funkce Aspose.Words umožňuje rozšířit proces Mail Merge:
- vložit checkboxES a pole formuláře pro zadávání textu do dokumentu během mail merge
- vkládejte obrázky z libovolného vlastního úložiště(soubory, pole BLOB atd.)
Vložte Checkboxes a zadávání textu během Mail Merge
Někdy je nutné provést operaci Mail Merge, aby v poli sloučení nebyl nahrazen text, ale checkbox nebo pole pro zadávání textu. I když to není nejběžnější scénář, je to velmi užitečné pro některé úkoly.
Následující snímek obrazovky dokumentu Word zobrazuje šablonu se sloučenými poli:

Tento snímek obrazovky níže uvedeného dokumentu Word ukazuje již vygenerovaný dokument:

Subject
bylo nahrazeno polem pro zadávání textu.
Následující příklad kódu ukazuje, jak vložit checkboxes a zadat textová pole do dokumentu během mail merge:
// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git. | |
Document doc = new Document(MyDir + "Mail merge destinations - Fax.docx"); | |
// Setup mail merge event handler to do the custom work. | |
doc.MailMerge.FieldMergingCallback = new HandleMergeField(); | |
// Trim trailing and leading whitespaces mail merge values. | |
doc.MailMerge.TrimWhitespaces = false; | |
string[] fieldNames = { | |
"RecipientName", "SenderName", "FaxNumber", "PhoneNumber", | |
"Subject", "Body", "Urgent", "ForReview", "PleaseComment" | |
}; | |
object[] fieldValues = { | |
"Josh", "Jenny", "123456789", "", "Hello", | |
"<b>HTML Body Test message 1</b>", true, false, true | |
}; | |
doc.MailMerge.Execute(fieldNames, fieldValues); | |
doc.Save(ArtifactsDir + "WorkingWithFields.MailMergeFormFields.docx"); |
// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git. | |
private class HandleMergeField : IFieldMergingCallback | |
{ | |
/// <summary> | |
/// This handler is called for every mail merge field found in the document, | |
/// for every record found in the data source. | |
/// </summary> | |
void IFieldMergingCallback.FieldMerging(FieldMergingArgs e) | |
{ | |
if (mBuilder == null) | |
mBuilder = new DocumentBuilder(e.Document); | |
// We decided that we want all boolean values to be output as check box form fields. | |
if (e.FieldValue is bool) | |
{ | |
// Move the "cursor" to the current merge field. | |
mBuilder.MoveToMergeField(e.FieldName); | |
string checkBoxName = $"{e.FieldName}{e.RecordIndex}"; | |
mBuilder.InsertCheckBox(checkBoxName, (bool) e.FieldValue, 0); | |
return; | |
} | |
switch (e.FieldName) | |
{ | |
case "Body": | |
mBuilder.MoveToMergeField(e.FieldName); | |
mBuilder.InsertHtml((string) e.FieldValue); | |
break; | |
case "Subject": | |
{ | |
mBuilder.MoveToMergeField(e.FieldName); | |
string textInputName = $"{e.FieldName}{e.RecordIndex}"; | |
mBuilder.InsertTextInput(textInputName, TextFormFieldType.Regular, "", (string) e.FieldValue, 0); | |
break; | |
} | |
} | |
} | |
void IFieldMergingCallback.ImageFieldMerging(ImageFieldMergingArgs args) | |
{ | |
args.ImageFileName = "Image.png"; | |
args.ImageWidth.Value = 200; | |
args.ImageHeight = new MergeFieldImageDimension(200, MergeFieldImageDimensionUnit.Percent); | |
} | |
private DocumentBuilder mBuilder; | |
} |
Vkládání obrázků během Mail Merge
Při provádění operace Mail Merge můžete do dokumentu vložit obrázky z databáze pomocí speciálních polí image Mail Merge. Pole image Mail Merge je sloučené pole s názvem Image:MyFieldName.
Vkládání obrázků z databáze
Během mail merge, když se v dokumentu objeví pole image Mail Merge, je vyvolána událost FieldMergingCallback. Na tuto událost můžete odpovědět a vrátit název souboru, stream nebo obrazový objekt do motoru Mail Merge, aby jej bylo možné vložit do dokumentu.
Následující příklad kódu ukazuje, jak vložit obrázky uložené v poli databáze BLOB do sestavy:
// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git. | |
Document doc = new Document(MyDir + "Mail merge destination - Northwind employees.docx"); | |
doc.MailMerge.FieldMergingCallback = new HandleMergeImageFieldFromBlob(); | |
string connString = "Provider=Microsoft.ACE.OLEDB.12.0;Data Source=" + DatabaseDir + "Northwind.accdb"; | |
OleDbConnection conn = new OleDbConnection(connString); | |
conn.Open(); | |
OleDbCommand cmd = new OleDbCommand("SELECT * FROM Employees", conn); | |
IDataReader dataReader = cmd.ExecuteReader(); | |
doc.MailMerge.ExecuteWithRegions(dataReader, "Employees"); | |
conn.Close(); | |
doc.Save(ArtifactsDir + "WorkingWithFields.MailMergeImageFromBlob.docx"); |
// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git. | |
public class HandleMergeImageFieldFromBlob : IFieldMergingCallback | |
{ | |
void IFieldMergingCallback.FieldMerging(FieldMergingArgs args) | |
{ | |
// Do nothing. | |
} | |
/// <summary> | |
/// This is called when mail merge engine encounters Image:XXX merge field in the document. | |
/// You have a chance to return an Image object, file name, or a stream that contains the image. | |
/// </summary> | |
void IFieldMergingCallback.ImageFieldMerging(ImageFieldMergingArgs e) | |
{ | |
// The field value is a byte array, just cast it and create a stream on it. | |
MemoryStream imageStream = new MemoryStream((byte[]) e.FieldValue); | |
// Now the mail merge engine will retrieve the image from the stream. | |
e.ImageStream = imageStream; | |
} | |
} |
Nastavení vlastností obrazu během Mail Merge
Při slučování pole pro sloučení obrázků může být někdy nutné ovládat různé vlastnosti obrázku, například WrapType.
V současné době můžete pomocí ImageFieldMergingArgs nastavit pouze vlastnosti šířky nebo výšky obrázku. K překonání tohoto problému poskytuje Aspose.Words Vlastnost Shape, která usnadňuje získání plné kontroly nad vloženým obrázkem nebo jakýmkoli jiným tvarem.
Následující příklad kódu ukazuje, jak nastavit různé vlastnosti obrázku:
// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git. | |
Document doc = new Document(); | |
DocumentBuilder builder = new DocumentBuilder(doc); | |
builder.Writeln("{{#foreach example}}"); | |
builder.Writeln("{{Image(126pt;126pt):stempel}}"); | |
builder.Writeln("{{/foreach example}}"); | |
doc.MailMerge.UseNonMergeFields = true; | |
doc.MailMerge.TrimWhitespaces = true; | |
doc.MailMerge.UseWholeParagraphAsRegion = false; | |
doc.MailMerge.CleanupOptions = MailMergeCleanupOptions.RemoveEmptyTableRows | |
| MailMergeCleanupOptions.RemoveContainingFields | |
| MailMergeCleanupOptions.RemoveUnusedRegions | |
| MailMergeCleanupOptions.RemoveUnusedFields; | |
doc.MailMerge.FieldMergingCallback = new ImageFieldMergingHandler(); | |
doc.MailMerge.ExecuteWithRegions(new DataSourceRoot()); | |
doc.Save(ArtifactsDir + "WorkingWithFields.MailMergeImageField.docx"); |
// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git. | |
private class ImageFieldMergingHandler : IFieldMergingCallback | |
{ | |
void IFieldMergingCallback.FieldMerging(FieldMergingArgs args) | |
{ | |
// Implementation is not required. | |
} | |
void IFieldMergingCallback.ImageFieldMerging(ImageFieldMergingArgs args) | |
{ | |
Shape shape = new Shape(args.Document, ShapeType.Image) | |
{ | |
Width = 126, Height = 126, WrapType = WrapType.Square | |
}; | |
shape.ImageData.SetImage(MyDir + "Mail merge image.png"); | |
args.Shape = shape; | |
} | |
} |
// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git. | |
public class DataSourceRoot : IMailMergeDataSourceRoot | |
{ | |
public IMailMergeDataSource GetDataSource(string s) | |
{ | |
return new DataSource(); | |
} | |
private class DataSource : IMailMergeDataSource | |
{ | |
private bool next = true; | |
string IMailMergeDataSource.TableName => TableName(); | |
private string TableName() | |
{ | |
return "example"; | |
} | |
public bool MoveNext() | |
{ | |
bool result = next; | |
next = false; | |
return result; | |
} | |
public IMailMergeDataSource GetChildDataSource(string s) | |
{ | |
return null; | |
} | |
public bool GetValue(string fieldName, out object fieldValue) | |
{ | |
fieldValue = null; | |
return false; | |
} | |
} | |
} |