Mail Merge Met regio ' s

U kunt verschillende regio ' s in uw sjabloon maken om speciale gebieden te hebben die u eenvoudig met uw gegevens kunt vullen. Gebruik Mail Merge Met regio ’s als u tabellen, rijen met herhalende gegevens wilt invoegen om uw documenten dynamisch te laten groeien door deze regio' s in uw sjabloon op te geven.

U kunt geneste (kind) regio ’s maken en regio' s samenvoegen. Het belangrijkste voordeel van het gebruik van dit type is om delen in een document dynamisch te vergroten. Zie meer details in het volgende artikel “geneste Mail Merge Met regio ’s”.

Informatie over een Mail Merge Regio kan worden verkregen met behulp van de MailMergeRegionInfo Klasse.

Mail Merge uitvoeren met regio ' s

Een Mail Merge regio is een specifiek deel in een document dat een begin-en eindpunt heeft. Beide punten worden weergegeven als Mail Merge velden met specifieke namen “TableStart:XXX” en “TableEnd:XXX”. Alle inhoud die is opgenomen in een Mail Merge - regio wordt automatisch herhaald voor elke record in de gegevensbron.

Met Aspose.Words kunt u Mail Merge uitvoeren met regio ' s met behulp van een van de ExecuteWithRegions methoden die IMailMergeDataSource aangepaste gegevensbron accepteren.

Het volgende codevoorbeeld laat zien hoe Mail Merge met regio ' s uit de SQLite-database met SQLiteCpp:

U kunt het verschil tussen het document opmerken voordat u Mail Merge uitvoert met regio ' s:

En na het uitvoeren van Mail Merge Met regio ' s:

Beperkingen van Mail Merge Met regio ' s

Er zijn enkele belangrijke punten waar u rekening mee moet houden bij het uitvoeren van een Mail Merge Met regio ' s:

• Het beginpunt TableStart:Orders en het eindpunt TableEnd:Orders moeten beide in dezelfde rij of cel staan. Als u bijvoorbeeld een samenvoeggebied start in een cel van een tabel, moet u het samenvoeggebied beëindigen in dezelfde rij als de eerste cel. De naam van het veld samenvoegen moet overeenkomen met de kolomnaam in uw DataTable. Tenzij u toegewezen velden opgeeft, zal Mail Merge Met regio ' s niet slagen voor een samenvoegveld met een andere naam dan de kolomnaam.
• Aspose.Words voor C++ ondersteunt alleen IMailMergeDataSource en IMailMergeDataSourceRoot gebaseerde gegevensbronnen. In tegenstelling tot .NET en Java heeft C++ geen algemeen aanvaarde cross-platform API voor het werken met databases (zoals ADODB, ODBC of JDBC). Om met een specifieke gegevensbron te werken, moet u IMailMergeDataSource of IMailMergeDataSourceRoot interface implementeren.

Als een van deze regels wordt overtreden, krijg je onverwachte resultaten of kan er een uitzondering worden gegooid.

Als u geen Mail Merge - regio ' s gebruikt, is deze vergelijkbaar met Microsoft Word mail merge en wordt de hele documentinhoud herhaald voor elke record in de gegevensbron.