Page History

...

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.

...

1. Use a single dimensional array
2. Use a multi-dimensional data source that AND
   1. the data source only has
   1
   1. one row of data
   Set the maximum number of rows to import to 1 with the DataBindingProperties object
   1. DataBindingProperties.MaxRowsToImport is set to 1

Single Dimensional Arrays

Methods:

• [PowerPointTemplate.BindData(Object[],String[],String,DataBindingProperties)]
• [PowerPointTemplate.BindData(Object[][],String[],String,DataBindingProperties)]
• [PowerPointTemplate.BindData(Object,,String[],String,DataBindingProperties)]

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.

If a multidimensional array (Object[,]) or a jagged array (Object[][]) contains multiple rows, PowerPointWriter will import all the rows using built-in repeating behavior. To import a single row of data using a multidimensional or jagged array, the array can only contain a single row of data. For more information about using arrays to import multiple rows of data, please see Importing Multiple Rows of Data.

Examples

One dimensional array:

            PowerPointTemplate pptt = new PowerPointTemplate();
            pptt.Open(@"C:\DataBinding\ArrayBindingTemplate.pptx");

            string[] values = {"Hello World", "subtitle"};
            string[] colNames = {"header", "subtitle"};
            DataBindingProperties DataProps = pptt.CreateDataBindingProperties();

            pptt.BindData(values, colNames, "DataSource1", DataProps);
            pptt.Process();
            pptt.Save(Page.Response,
               "ArrayBinding.pptx",
               false);

        Dim pptt As New PowerPointTemplate()
        pptt.Open("C:\DataBinding\ArrayBindingTemplate.pptx")


        Dim values = New String() {"Hello World", "subtitle"}
        Dim colNames = New String() {"header", "subtitle"}
        Dim DataProps As DataBindingProperites = pptt.CreateDataBindingProperties();

        pptt.BindData(values, colNames, "DataSource1", DataProps);
        pptt.Process()
        pptt.Save(Page.Response, _
              "ArrayBinding.pptx", _
               False)

Multi-dimensional data sources

Data source with one row of data

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.

Other data sources - Setting MaxRowsToImport

...