EntityDataTableAdapter Class

  • Article

NOTE: This API is now obsolete.

Transforms an IEntityInstanceEnumerator object into a Microsoft ADO.NET DataTable object. Each data row in the table represents an entity instance in the enumerator.

Inheritance Hierarchy

System.Object
  Microsoft.Office.Server.ApplicationRegistry.Runtime.EntityDataTableAdapter

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

Syntax

'Declaration
<ObsoleteAttribute("O12 Application Registry API is deprecated. Please use BusinessData.",  _
    False)> _
<SharePointPermissionAttribute(SecurityAction.LinkDemand, ObjectModel := True)> _
<SharePointPermissionAttribute(SecurityAction.InheritanceDemand, ObjectModel := True)> _
Public Class EntityDataTableAdapter
'Usage
Dim instance As EntityDataTableAdapter

[ObsoleteAttribute("O12 Application Registry API is deprecated. Please use BusinessData.", 
    false)]
[SharePointPermissionAttribute(SecurityAction.LinkDemand, ObjectModel = true)]
[SharePointPermissionAttribute(SecurityAction.InheritanceDemand, ObjectModel = true)]
public class EntityDataTableAdapter

Remarks

The DataTable object is a central object in the ADO.NET library, and represents one table of in-memory data.

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.

Also, unlike an enumerator that supports streaming, you lose streaming when you transform an enumerator into a data table because the entire set of rows is loaded into memory at once.

Also there is a performance hit to set up the DataTable schema, rows and copy and set up all the fields.

Therefore, because the above three reasons, use the enumerator instead of the DataTable object whenever possible.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

See Also

Reference

EntityDataTableAdapter Members

Microsoft.Office.Server.ApplicationRegistry.Runtime Namespace