Sets the specified repeat block's data source to an ADO.NET DataTable. 

 public void SetRepeatBlock(System.Data.DataTable dt, System.String bookmark)

Public Sub SetRepeatBlock(ByVal dt As System.Data.DataTable, ByVal bookmark As String)

The DataTable 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:

  1. Open the template in Microsoft Word.
  2. Open the Edit menu.
  3. Select Go To...
  4. Select Bookmark.
  5. Under Enter bookmark name, open the drop-down list of bookmark names.

SetRepeatBlock will throw this exception if null (C#) or Nothing (VB.NET) is passed to the method.

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.

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 DataTable to SetRepeatBlock, WordWriter will not include the specified repeat block in the generated Word file.


          //--- A DataTable with the data to be repeated
          DataTable ds = GetDataTable();
          WordTemplate oWW = new WordTemplate();
          oWW.Open("c:\\template.doc");

          //--- Set a data source for the repeat block
          //--- defined by the bookmark "Page"
          //--- "dt" is the DataTable containing the data to be
          //--- imported and repeated in the repeat block
          oWW.SetRepeatBlock(dt, "Page");
          oWW.Process();
          oWW.Save(Page.Response, "Output.doc", false);
        

          '--- A DataTable with the data to be repeated
          Dim ds As DataTable = GetDataTable()
          Dim oWW As New WordTemplate()
          oWW.Open("c:\template.doc")

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