CreateEntity(Type) Method

Visual Basic
C#

'Declaration
 
Public Overloads Function CreateEntity( _
   ByVal entityType As Type _
) As Object

'Usage
 
Dim instance As EntityManager
Dim entityType As Type
Dim value As Object
 
value = instance.CreateEntity(entityType)

public object CreateEntity( 
   Type entityType
)

Parameters

entityType: Entity type

Return Value

A new instance of the specified entity type

Exception	Description
System.ArgumentOutOfRangeException	Bad entity type

You may either "new" a business object (unless it's Abstract (or MustInherit in Visual Basic), or use one of the overloaded CreateEntity methods. Any new entity has a "detached" EntityState until added to the EntityManager cache using either AddEntity or the object's EntityAspect.AddToManager method.

The "entity set" is a construct within the Entity Framework which allows you to logically group entities of the same type. See EntityQuery.EntitySetName for more information. If an entity set name is not provided then the EntityGroup.DefaultEntitySetName is used.

C#

DomainModelEntityManager mgr = new DomainModelEntityManager();

// Retrieve an order
Order order = mgr.Orders.FirstOrNullEntity(o=> o.OrderID == 1);
// Retrieve a product
Product product = mgr.Products.FirstOrNullEntity(p => p.ProductID == 1);

// Create an OrderDetail 
OrderDetail dtl = mgr.CreateEntity<OrderDetail>();
// assign key fields
dtl.OrderSummary = order;
dtl.Product = product;

// add the OrderDetail to the EntityManager cache
DebugFns.WriteLine("entity state before add = " + dtl.EntityState);
dtl.AddToManager();
DebugFns.WriteLine("entity state after add = " + dtl.EntityState);

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

EntityManager Class
EntityManager Members
Overload List
AddEntity Method