Csla.IDataPortal< T > Interface Template Reference

Interface defining the members of the data portal type. More...

Inheritance diagram for Csla.IDataPortal< T >:

Public Member Functions
Task< object >	CreateAsync (params object[] criteria)
	Starts an asynchronous data portal operation to create a business object. More...
Task< object >	FetchAsync (params object[] criteria)
	Starts an asynchronous data portal operation to create a business object. More...
Task< object >	UpdateAsync (object obj)
	Called by a factory method in a business class or by the UI to update an object. More...
Task< object >	ExecuteAsync (object command)
	Called by a factory method in a business class or by the UI to execute a command object. More...
Task	DeleteAsync (params object[] criteria)
	Called by a factory method in a business class or by the UI to delete an object. More...
object	Create (params object[] criteria)
	Called by a factory method in a business class to create a new object, which is loaded with default values from the database. More...
object	Fetch (params object[] criteria)
	Called by a factory method in a business class to retrieve an object, which is loaded with values from the database. More...
object	Execute (object obj)
	Called to execute a Command object on the server. More...
object	Update (object obj)
	Insert, update or delete an object in the database. More...
void	Delete (params object[] criteria)
	Called by a Shared (static in C#) method in the business class to cause immediate deletion of a specific object from the database. More...
Task< T >	CreateAsync (params object[] criteria)
	Starts an asynchronous data portal operation to create a business object. More...
Task< T >	FetchAsync (params object[] criteria)
	Starts an asynchronous data portal operation to create a business object. More...
Task< T >	UpdateAsync (T obj)
	Called by a factory method in a business class or by the UI to update an object. More...
Task< T >	ExecuteAsync (T command)
	Called by a factory method in a business class or by the UI to execute a command object. More...
Task	DeleteAsync (params object[] criteria)
	Called by a factory method in a business class or by the UI to delete an object. More...
T	Create (params object[] criteria)
	Called by a factory method in a business class to create a new object, which is loaded with default values from the database. More...
T	Fetch (params object[] criteria)
	Called by a factory method in a business class to retrieve an object, which is loaded with values from the database. More...
T	Execute (T obj)
	Called to execute a Command object on the server. More...
T	Update (T obj)
	Called by the business object's Save() method to insert, update or delete an object in the database. More...
void	Delete (params object[] criteria)
	Called by a Shared (static in C#) method in the business class to cause immediate deletion of a specific object from the database. More...

Detailed Description

Interface defining the members of the data portal type.

Template Parameters

T

Definition at line 16 of file IDataPortalT.cs.

Member Function Documentation

Create() [1/2]

object Csla.IDataPortal< T >.Create

(

params object[]

criteria

)

Called by a factory method in a business class to create a new object, which is loaded with default values from the database.

Parameters

criteria

Object-specific criteria.

Returns

A new object, populated with default values.

Implemented in Csla.DataPortal< T >.

Create() [2/2]

T Csla.IDataPortal< T >.Create

(

params object[]

criteria

)

Called by a factory method in a business class to create a new object, which is loaded with default values from the database.

Parameters

criteria

Object-specific criteria.

Returns

A new object, populated with default values.

Implemented in Csla.DataPortal< T >.

CreateAsync() [1/2]

Task< object > Csla.IDataPortal< T >.CreateAsync

(

params object[]

criteria

)

Starts an asynchronous data portal operation to create a business object.

Parameters

criteria

Criteria describing the object to create.

Implemented in Csla.DataPortal< T >.

CreateAsync() [2/2]

Task< T > Csla.IDataPortal< T >.CreateAsync

(

params object[]

criteria

)

Starts an asynchronous data portal operation to create a business object.

Parameters

criteria

Criteria describing the object to create.

Implemented in Csla.DataPortal< T >.

Delete() [1/2]

void Csla.IDataPortal< T >.Delete

(

params object[]

criteria

)

Called by a Shared (static in C#) method in the business class to cause immediate deletion of a specific object from the database.

Parameters

criteria

Object-specific criteria.

Implemented in Csla.DataPortal< T >.

Delete() [2/2]

void Csla.IDataPortal< T >.Delete

(

params object[]

criteria

)

Called by a Shared (static in C#) method in the business class to cause immediate deletion of a specific object from the database.

Parameters

criteria

Object-specific criteria.

Implemented in Csla.DataPortal< T >.

DeleteAsync() [1/2]

Task Csla.IDataPortal< T >.DeleteAsync

(

params object[]

criteria

)

Called by a factory method in a business class or by the UI to delete an object.

Parameters

criteria

Object-specific criteria.

Implemented in Csla.DataPortal< T >.

DeleteAsync() [2/2]

Task Csla.IDataPortal< T >.DeleteAsync

(

params object[]

criteria

)

Called by a factory method in a business class or by the UI to delete an object.

Parameters

criteria

Object-specific criteria.

Implemented in Csla.DataPortal< T >.

Execute() [1/2]

object Csla.IDataPortal< T >.Execute

(

object

obj

)

Called to execute a Command object on the server.

To be a Command object, the object must inherit from CommandBase.

Note that this method returns a reference to the updated business object. If the server-side DataPortal is running remotely, this will be a new and different object from the original, and all object references MUST be updated to use this new object.

On the server, the Command object's DataPortal_Execute() method will be invoked and on an ObjectFactory the Execute method will be invoked. Write any server-side code in that method.

Parameters

obj	A reference to the Command object to be executed.

Returns

A reference to the updated Command object.

Execute() [2/2]

T Csla.IDataPortal< T >.Execute

(

T

obj

)

Called to execute a Command object on the server.

To be a Command object, the object must inherit from CommandBase.

Note that this method returns a reference to the updated business object. If the server-side DataPortal is running remotely, this will be a new and different object from the original, and all object references MUST be updated to use this new object.

On the server, the Command object's DataPortal_Execute() method will be invoked and on an ObjectFactory the Execute method will be invoked. Write any server-side code in that method.

Parameters

obj	A reference to the Command object to be executed.

Returns

A reference to the updated Command object.

Implemented in Csla.DataPortal< T >.

ExecuteAsync() [1/2]

Task< object > Csla.IDataPortal< T >.ExecuteAsync

(

object

command

)

Called by a factory method in a business class or by the UI to execute a command object.

Parameters

command

Command object to execute.

ExecuteAsync() [2/2]

Task< T > Csla.IDataPortal< T >.ExecuteAsync

(

T

command

)

Called by a factory method in a business class or by the UI to execute a command object.

Parameters

command

Command object to execute.

Implemented in Csla.DataPortal< T >.

Fetch() [1/2]

object Csla.IDataPortal< T >.Fetch

(

params object[]

criteria

)

Called by a factory method in a business class to retrieve an object, which is loaded with values from the database.

Parameters

criteria

Object-specific criteria.

Returns

An object populated with values from the database.

Implemented in Csla.DataPortal< T >.

Fetch() [2/2]

T Csla.IDataPortal< T >.Fetch

(

params object[]

criteria

)

Called by a factory method in a business class to retrieve an object, which is loaded with values from the database.

Parameters

criteria

Object-specific criteria.

Returns

An object populated with values from the database.

Implemented in Csla.DataPortal< T >.

FetchAsync() [1/2]

Task< object > Csla.IDataPortal< T >.FetchAsync

(

params object[]

criteria

)

Starts an asynchronous data portal operation to create a business object.

Parameters

criteria

Criteria describing the object to create.

Implemented in Csla.DataPortal< T >.

FetchAsync() [2/2]

Task< T > Csla.IDataPortal< T >.FetchAsync

(

params object[]

criteria

)

Starts an asynchronous data portal operation to create a business object.

Parameters

criteria

Criteria describing the object to create.

Implemented in Csla.DataPortal< T >.

Update() [1/2]

object Csla.IDataPortal< T >.Update

(

object

obj

)

Insert, update or delete an object in the database.

Note that this method returns a reference to the updated business object. If the server-side DataPortal is running remotely, this will be a new and different object from the original, and all object references MUST be updated to use this new object.

Parameters

obj	A reference to the business object to be updated.

Returns

A reference to the updated business object.

Update() [2/2]

T Csla.IDataPortal< T >.Update

(

T

obj

)

Called by the business object's Save() method to insert, update or delete an object in the database.

Note that this method returns a reference to the updated business object. If the server-side DataPortal is running remotely, this will be a new and different object from the original, and all object references MUST be updated to use this new object.

Parameters

obj	A reference to the business object to be updated.

Returns

A reference to the updated business object.

Implemented in Csla.DataPortal< T >.

UpdateAsync() [1/2]

Task< object > Csla.IDataPortal< T >.UpdateAsync

(

object

obj

)

Called by a factory method in a business class or by the UI to update an object.

Parameters

obj	Object to update.

UpdateAsync() [2/2]

Task< T > Csla.IDataPortal< T >.UpdateAsync

(

T

obj

)

Called by a factory method in a business class or by the UI to update an object.

Parameters

obj	Object to update.

Implemented in Csla.DataPortal< T >.