AbstractEntityInstance.EntityAsDataRow Method (DataTable, Boolean)

NOTE: This API is now obsolete.

When overridden in a derived class, exposes the entity instance with or without fields with complex formatting as a DataRow object in the specified DataTable object.

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)> _
Protected Overridable Function EntityAsDataRow ( _
    tableToAddRowTo As DataTable, _
    formattedFields As Boolean _
) As DataRow
'Usage
Dim tableToAddRowTo As DataTable
Dim formattedFields As Boolean
Dim returnValue As DataRow

returnValue = Me.EntityAsDataRow(tableToAddRowTo, _
    formattedFields)

[ObsoleteAttribute("O12 Application Registry API is deprecated. Please use BusinessData.", 
    false)]
protected virtual DataRow EntityAsDataRow(
    DataTable tableToAddRowTo,
    bool formattedFields
)

Parameters

• tableToAddRowTo
  Type: System.Data.DataTable

  The DataTable object to add the entity instance as a row to.

• formattedFields
  Type: System.Boolean

  true if the entity instance contains complex fields and must create a DataRow with the formatted data; otherwise, false.

Return Value

Type: System.Data.DataRow
A DataRow object containing all the fields including the complex fields in the entity instance.

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. Therefore, you should transform entity instances into data rows only if absolutely necessary. Avoid using ADO.NET adapters that convert Business Data Catalog return types for maximum performance.

See Also

Reference

AbstractEntityInstance Class

AbstractEntityInstance Members

EntityAsDataRow Overload

Microsoft.Office.Server.ApplicationRegistry.Runtime Namespace