EntityDataTableAdapter Constructor (IEntityInstanceEnumerator, Int32, Boolean)

Transforms the specified number of entity instances in an IEntityInstanceEnumerator object into a Microsoft ADO.NET DataTable object, also serializing the ID column. Each data row in the table represents an entity instance in the enumerator.

Namespace:  Microsoft.Office.Server.ApplicationRegistry.Runtime
Assembly:  Microsoft.SharePoint.Portal (in Microsoft.SharePoint.Portal.dll)

Syntax

'Declaration
Public Sub New ( _
    dataSource As IEntityInstanceEnumerator, _
    rowCount As Integer, _
    createSerializedIdColumn As Boolean _
)

'Usage
Dim dataSource As IEntityInstanceEnumerator
Dim rowCount As Integer
Dim createSerializedIdColumn As Boolean

Dim instance As New EntityDataTableAdapter(dataSource, _
    rowCount, createSerializedIdColumn)

public EntityDataTableAdapter(
    IEntityInstanceEnumerator dataSource,
    int rowCount,
    bool createSerializedIdColumn
)

Parameters

• dataSource
  Type: Microsoft.Office.Server.ApplicationRegistry.Runtime.IEntityInstanceEnumerator
  An IEntityInstanceEnumerator object to be transformed.

• rowCount
  Type: System.Int32
  The number of entity instances to be transformed.
  Unlike an enumerator that supports streaming, you lose streaming when you convert an enumerator into a table because the entire set of rows is loaded into memory. You can use this constructor to limit the number of rows in the data table.

• createSerializedIdColumn
  Type: System.Boolean
  true or false, depending on whether you want to serialize the ID column in the data table.

Remarks

When entity instances are transformed into data rows in a data table, they lose the special semantics attached to them in the Business Data Catalog, such as the ability to call instance methods on them. Serializing the ID column enables you to call instance methods. You can access the ID column using the name ColNameSerializedId.

Because the Business Data Catalog encodes the ID column, you must decode the ID column before you can use the ID values. To decode the ID column, use the EntityInstanceIdEncoder.DecodeEntityInstanceId(ColNameSerializedId) method. This method decodes the identifiers and returns an array of identifier values.

See Also

Reference

EntityDataTableAdapter Class

EntityDataTableAdapter Members

EntityDataTableAdapter Overload

Microsoft.Office.Server.ApplicationRegistry.Runtime Namespace