Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migration of unmigrated content due to installation of a new plugin

...

Description

Excerpt

Sets an IEnumerable as a data source to bind to template data markers.

Signature
C#
C#
public void BindData(System.Collections.Generic.IEnumerable dataSource, System.String dataSourceName, DataBindingProperties property)
{signature}{signature:
}
Signature
vb.net
vb.net
Public Sub BindData(ByVal dataSource As System.Collections.Generic.IEnumerable, ByVal dataSourceName As String, ByVal [property] As DataBindingProperties)
{signature}
{parameters}
{param:dataSource}The IEnumerable collection to use as the data source.{param}
{param:dataSourceName}The name of the set of data markers at which to insert the values imported from the data source. Note: {{dataSourceName}} does not include a data marker's column name, for example, the {{dataSourceName}} for {{%%=Products.ProductID}} is "Products."{param}
{param:property}The [DataBindingProperties|DataBindingProperties] object which contains information about how the data should be bound to the template.  To bind data to a template with the default {{DataBindingProperties}}, pass in {{PowerPointTemplate.CreateDataBindingProperties()}} as the {{property}} value.{param}
{exceptions}{exception:ArgumentNullException}
{{BindData}} will throw this exception if {{null}} \(C\#\) or {{Nothing}} \(VB.NET\) is passed to the method.{exception}
{example}
{code:csharp|title=C#}
Parameters
Param
dataSource
dataSource

The IEnumerable collection to use as the data source.

Param
dataSourceName
dataSourceName

The name of the set of data markers at which to insert the values imported from the data source. Note: dataSourceName does not include a data marker's column name, for example, the dataSourceName for %%=Products.ProductID is "Products."

Param
property
property

The DataBindingProperties object which contains information about how the data should be bound to the template. To bind data to a template with the default DataBindingProperties, pass in PowerPointTemplate.CreateDataBindingProperties() as the property value.

Exceptions
Exception
ArgumentNullException
ArgumentNullException

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

Example
Code Block
csharp
csharp
titleC#


          PowerPointTemplate pptt = new PowerPointTemplate();

          interface IOrder
          {
               int OrderID;
               string Customer;
               DateTime OrderDate;
               float OrdersTotal;
          }


          IEnumerable<IOrder> orders = GetOrders();
          pptt.BindData(orders, "Orders", pptt.CreateDataImportProperties());
{code} {code:vbnet|title=
Code Block
vbnet
vbnet
titlevb.net
}

          Dim pptt As New PowerPointTemplate()
          Interface IOrder
               Property OrderID() as Int32
               Property Customer() as String
               Property OrderDate() as DateTime
               Property OrdersTotal() as Single
          End Interface

          Dim orders as IEnumerable(Of Order) = GetOrders()
          pptt.BindData(orders, "Orders", pptt.CreateDataImportProperties())
{code} {example}