Sets the specified repeat block's data source to a 1-dimensional array of objects. 

 public void SetRepeatBlock(System.Object[] dataRow, System.String[] fieldNames, System.String bookmark)

Public Sub SetRepeatBlock(ByVal dataRow As Object(), ByVal fieldNames As String(), ByVal bookmark As String)

An object array of values to use as a data source. WordWriter will insert these values in the repeat block's merge fields. Objects in the array must not be arrays themselves. Objects in the array can be null. Each object in the data source array must have a corresponding field name in the array of field names.

A string array of data source field names. These must be the same as the corresponding merge field names in the template. The array of data source values and the array of field names must contain the same number of elements.

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


          string[] NamesArr = {"CompanyName", "ProductName", "URL"};
          object[] ValuesArr = {"SoftArtisans", "WordWriter",
               "http://www.softartisans.com"};
          WordTemplate WordTempl = new WordTemplate();
          WordTempl.Open(Page.MapPath("./BasicTemplate.doc"));

          //--- Set the data source of the repeat block "ProductInfo"
          //--- by passing the value array and the name array initialized above.
          WordTempl.SetRepeatBlock(ValuesArr, NamesArr, "ProductInfo");
          WordTempl.Process();
          WordTempl.Save(Page.Response, "BasicGenerated.doc", false);
        

          Dim NamesArr As String() = {"CompanyName", "ProductName", "URL"}
          Dim ValuesArr As Object() = {"SoftArtisans", "WordWriter", _
               "http://www.softartisans.com"}
          Dim WordTempl As new WordTemplate()
          WordTempl.Open(Page.MapPath("./BasicTemplate.doc"))

          '--- Set the data source of the repeat block "ProductInfo"
          '--- by passing the value array and the name array initialized above.
          WordTempl.SetRepeatBlock(ValuesArr, NamesArr, "ProductInfo")
          WordTempl.Process()
          WordTempl.Save(Page.Response, "BasicGenerated.doc", False)