Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migration of unmigrated content due to installation of a new plugin

...

Remarks

You can call SetRepeatBlock several times for a single instance of WordTemplate. The repeat block specified by the parameter bookmark must exist in the template.

If you pass an empty DataSet to SetRepeatBlock, WordWriter will not include the specified repeat block in the generated Word file.

Not all Word features can be included in a repeat block:

Web only
To see a full chart of limitations, go to our online documentation:
To see a full chart of limitations, go to our online documentation:

Supported in Repeat Blocks

Not Supported in Repeat Blocks

  • Character Formatting (everywhere)
  • Paragraph Formatting (Alignment, Outlines, Indent, Spacing, Page Break before, Keep Together)
  • Multiple Columns (2, 3, Column Breaks)
  • Borders and Shading
  • Tabs
  • Bullets
  • Numbering (numbering not reset, it is continued from one repeat block to another)
  • Page Breaks
  • Section Breaks
  • Auto Text Field
  • Hyperlink
  • Pictures
  • Table Row Repeat (entire row only)
  • Fields (with some restrictions)
  • Nested repeat blocks (Only one data source may be assigned to a single repeat block.)
  • Overlapping bookmarks
  • Comments
  • Drawing Objects
  • Text Boxes
  • Footnote and endnote references
  • Table and picture indexes
  • Single cell in a table
  • Smart tags (smart tags will be removed from the document)
  • Repeat blocks in headers, footers, footnotes, comments, text boxes, etc.
Web only

Example
Code Block
csharp
csharp
titleC#
          //--- A dataset with the data to be repeated
          DataSet ds = GetDataSet();
          WordTemplate oWW = new WordTemplate();
          oWW.Open("c:\\template.doc");

          //--- Set a data source for the repeat block
          //--- defined by the bookmark "Page"
          //--- "ds" is the DataSet containing the data to be
          //--- imported and repeated in the repeat block
          //--- The first DataTable in the DataSet will be used
          oWW.SetRepeatBlock(ds, "Page");
          oWW.Process();
          oWW.Save(Page.Response, "Output.doc", false);
Code Block
vb.net
vb.net
titlevb.net
          '--- A dataset with the data to be repeated
          Dim ds As DataSet = GetDataSet()
          Dim oWW As New WordTemplate()
          oWW.Open("c:\template.doc")

          '--- Set a data source for the repeat block
          '--- defined by the bookmark "Page"
          '--- "ds" is the DataSet containing the data to be
          '--- imported and repeated in the repeat block
          '--- The first DataTable in the DataSet will be used
          oWW.SetRepeatBlock(ds, "Page")
          oWW.Process()
          oWW.Save(Page.Response, "Output.doc", False)