General Actions:
DevForce 2010 Resource Center » DevForce development » Start » EntityManager » Create an EntityManager
Last modified on August 15, 2012 17:20
Construct a bare EntityManager
Call "new" to construct a new instance of the EntityManager class. It can be as simple as
| C# | manager = new EntityManager(); |
| VB | manager = New EntityManager() |
That manager is ready to use with any entity class model available. This default constructor assumes that you want to contact the server as soon as possible and starts connecting immediately (asynchronously in Silverlight).
You won't be able to do anything with the manager until you've established a security context for the EntityManager. That isn't readily apparent out-of-the-box because DevForce grants all users full access rights; you can use the newly created EntityManager to query and save without doing anything.
You are sure to impose authentication constraints of some sort and when you do, the EntityManager will refuse to send any messages to the server until those constraints are met.
Construct the EntityManager for your entity model
The entity model you created using the Entity Data Model Designer also generated a custom EntityManager for you, one that derives from the DevForce EntityManager class and is enriched with additional members that make it easier to work with your entity model.
Peek inside the generated code file (e.g., NorthwindIBEntitiesIB.Designer.cs). Notice the custom EntityManager near the top of the file. It might looks a bit like this:
| C# | IbEm.DataSourceKeyName(@"NorthwindEntities")] public partial class NorthwindEntities : IbEm.EntityManager { // .. } |
| VB | <IbEm.DataSourceKeyName("NorthwindEntities")> Partial Public Class NorthwindEntities Inherits IbEm.EntityManager ' .. End Class |
You can construct one of these as you did the bare DevForce EntityManager.
| C# | manager = new NorthwindEntities(); |
| VB | manager = New NorthwindEntities() |
Look further in the generated code to find several constructors that enable you to determine initial characteristics of the EntityManager. The first is the constructor you called above; all of its parameters are optional.
| C# | public NorthwindManager( bool shouldConnect=true, // Whether to start connecting to the server immediately string dataSourceExtension=null, // optional target environment IbEm.EntityServiceOption entityServiceOption=IbEm.EntityServiceOption.UseDefaultService, string compositionContextName=null) : base(shouldConnect, dataSourceExtension, entityServiceOption, compositionContextName) {} |
| VB | Public Sub New(Optional ByVal _ shouldConnect As Boolean =True, _ Optional ByVal dataSourceExtension As String =Nothing, _ Optional ByVal entityServiceOption As IbEm.EntityServiceOption =IbEm.EntityServiceOption.UseDefaultService, _ Optional ByVal compositionContextName As String =Nothing) MyBase.New(shouldConnect, dataSourceExtension, entityServiceOption, compositionContextName) End Sub |
Another generated constructor gathers all options together into an EntityManagerContext. The EntityManagerContext allows for additional settings not available in the other constructors, including options to control refetch behavior and connect to a non-default application server.
| C# | public NorthwindManager( IbEm.EntityManagerContext entityManagerContext) : base(entityManagerContext) {} |
| VB | Public Sub New(ByVal entityManagerContext As IbEm.EntityManagerContext) MyBase.New(entityManagerContext) End Sub |
These constructors are available for the base EntityManager class too. You can read the DevForce API documentation for details about these parameters and the other constructors.
You might consider a brief digression now to learn about creating a disconnected EntityManager and creating EntityManagers that target different databases under different execution scenarios.
Custom EntityQuery properties
The custom EntityQuery properties are one reason you may prefer to create a new custom EntityManager such as NorthwindEntities rather than a bare-bones EntityManager.
Peeking again at the generated code for NorthwindEntities we find query properties generated for each of the entity types. Here is one for querying Customers.
| C# | public IbEm.EntityQuery<Customer> Customers { get { return new IbEm.EntityQuery<Customer>("Customers", this); } // IbEm == IdeaBlade.EntityModel } |
| VB | Public ReadOnly Property Customers() As IbEm.EntityQuery(Of Customer) Get ' IbEm == IdeaBlade.EntityModel Return New IbEm.EntityQuery(Of Customer)("Customers", Me) End Get End Property |
It's a nice touch - a bit of syntactic sugar - that can make a LINQ query a little easier for developers to read and write:
| C# | query1 = northwindManager.Customer.Where(...); query2 = bareManager.GetQuery<Customer>().Where(...); |
| VB | query1 = northwindManager.Customer.Where(...) query2 = bareManager.GetQuery(Of Customer)().Where(...) |
The two queries are functionally the same. Most developers prefer query1.