Page History

...

{introducedin:4.1.0.1379

...

...

}
{description}
{excerpt}Sets the specified repeat block's data source to a SharePoint List.

...

 
{excerpt}
{signature:C#}
public static void SetRepeatBlock(this WordTemplate template, Microsoft.SharePoint.SPList list, System.String bookmark)

{signature}
{signature:vb.net

}
Public Shared Sub SetRepeatBlock(ByVal template As WordTemplate, ByVal list As Microsoft.SharePoint.SPList, ByVal bookmark As String)

...

The current WordTemplate object calling SetRepeatBlock

...

The SharePoint List 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.

{signature}
{parameters}
{param:template}The current WordTemplate object calling SetRepeatBlock{param}
{param:list}The SharePoint List to use as the data source.
{param}
{param:bookmark}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.
{param}
{exceptions}
{exception:ArgumentNullException}{{SetRepeatBlock}} will throw this exception if {{null}} \(C\#\) or {{Nothing}} \(VB.NET\) is passed to the method.
{exception}
{exception:ArgumentException}
{exception}
{remarks}
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|WordTemplate.SetRepeatBlock] several times for a single instance of [WordTemplate]. The repeat block specified by the parameter {{bookmark}} must exist in the template.
{note}This is an extension method for the WordTemplate object to be used for binding SharePoint data to applications from within SharePoint.  To use this method, you must add a reference to SoftArtisans.OfficeWriter.WordWriter.SharePointIntegration.dll

{note}
{remarks}
{example}{code:csharp|title=C#}

          //--- Set a data source for the repeat block
          //--- defined by the bookmark "Page"
          //--- "myList" is the SharePoint List containing the data to be
          //--- imported and repeated in the repeat block
          oWW.SetRepeatBlock(myList, "Page");
          oWW.Process();
        

{code}
{code:vb.net

|title=vb.net

}

          '--- Set a data source for the repeat block
          '--- defined by the bookmark "Page"
          '--- "myList" is the SharePoint List containing the data to be
          '--- imported and repeated in the repeat block
          oWW.SetRepeatBlock(myList, "Page")
          oWW.Process()
        {code}

{example}