Sets the specified repeat block's data source to an ADO.NET DataSet.
dsThe DataSet to use as the data source.
The bookmark name of the template repeat block. The bookmark passed to
SetRepeatBlock must exist in the template Word file. To see a list of template bookmark names:
- Open the template in Microsoft Word.
- Open the Edit menu.
- Select Go To...
- Select Bookmark.
- Under Enter bookmark name, open the drop-down list of bookmark names.
maxRowsSpecifies the maximum number of repetitions to write to the file. If Next fields are enabled (see EnableNEXTFields), then the number of rows imported from the data source is
maxRows*(numberOfNextFields+1). If Next fields are not enabled the number of rows imported is equal to the number of repetitions written out. To write the maximum rows available, use the constant WordTemplate.ALL_ROWS.
SetRepeatBlock will throw this exception if
null (C#) or
Nothing (VB.NET) is passed to the method.
Introduced in build 8.4
SetRepeatBlock will throw this exception if the
bookmark has been set to be removed.
A repeat block is a fragment in the template document that will be repeated for each row in a data source. In the template document, repeat blocks are defined by Word bookmarks that contain merge fields.
If you pass an empty DataSet to
SetRepeatBlock - by either setting
maxRows to 0 or passing an empty DataSet - WordWriter will not include the specified repeat block in the generated Word file.
Not all Word features can be included in a repeat block:$body
Supported in Repeat Blocks
Not Supported in Repeat Blocks