Intro
This guide will explain how to import a single row of values into a PowerPoint presentation using data markers. This assumes a basic understanding of data markers.Setting up the Template
The template file should contain data markers following proper data marker syntax. Each copy of a given data marker will be populated with the same value. If the data marker appears in a table row or list entry, nothing will be automatically repeated if only one row is imported.
Binding Data
PowerPointTemplate has a single method for binding data to the data markers that are located in the template: PowerPointTemplate.BindData. Depending on the data source type and the number of rows in the data source, PowerPointWriter will either import a single row of data or import multiple rows.
There are several ways to import a single row of data into a presentation:
- Use a single dimensional array
- Use a multi-dimensional data source AND
- The data source only has one row of data
- DataBindingProperties.MaxRowsToImport is set to 1
Single Dimensional Arrays
Arrays don't have built-in means to store column names. The user must specify the column names in a string array that is passed to {{PowerPointTemplate.BindData}} at run time.
Multi-dimensional data sources
If a multi-dimensional data source has only one row of data, the automatic repeating behavior will not occur. This is consistent for any of the multi-dimensional data sources supported by BindData:
- Jagged and multi-dimensional arrays
- Custom objects (IEnumerable<T>)
- System.IDataReader and System.DataTable
Setting MaxRowsToImport to 1
MaxRowsToImport is a property on the DataBindingProperties object that can be used to limit the number of rows that are imported, regardless of how many rows are actually in the data source.