IdeaBlade DevForce 2010 Help Reference
CreateEntity(Type) Method
See Also  Example Send Feedback
IdeaBlade.EntityModel Assembly > IdeaBlade.EntityModel Namespace > EntityManager Class > CreateEntity Method : CreateEntity(Type) Method



entityType
Entity type
Create a new entity of the requested type.

Syntax

Visual Basic (Declaration) 
Public Overloads Function CreateEntity( _
   ByVal entityType As Type _
) As Object
Visual Basic (Usage)Copy Code
Dim instance As EntityManager
Dim entityType As Type
Dim value As Object
 
value = instance.CreateEntity(entityType)
C# 
public object CreateEntity( 
   Type entityType
)
C++/CLI 
public:
Object^ CreateEntity( 
   Type^ entityType
) 

Parameters

entityType
Entity type

Return Value

A new instance of the specified entity type

Exceptions

ExceptionDescription
System.ArgumentOutOfRangeExceptionBad entity type

Example

C#Copy Code
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);

Remarks

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" EntityAspect.EntityState until added to the EntityManager cache using either IdeaBlade.EntityModel.EntityManager.AddEntity or the object's IdeaBlade.EntityModel.EntityAspect.AddToManager method.

Requirements

Target Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, Windows Vista, Windows Server 2008 family

See Also

© 2013 All Rights Reserved.