CSLA .NET 10.0.0
A home for your business logic
Loading...
Searching...
No Matches
Csla.IDataPortal Interface Reference

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

Inheritance diagram for Csla.IDataPortal:
Csla.DataPortal< T >

Public Member Functions

Task< ICslaObjectCreateAsync (params object?[]? criteria)
 Starts an asynchronous data portal operation to create a business object.
Task< ICslaObjectFetchAsync (params object?[]? criteria)
 Starts an asynchronous data portal operation to create a business object.
Task< ICslaObjectUpdateAsync (ICslaObject obj)
 Called by a factory method in a business class or by the UI to update an object.
Task< ICslaObjectExecuteAsync (ICslaObject command)
 Called by a factory method in a business class or by the UI to execute a command object.
Task< ICslaObjectExecuteAsync (params object?[]? criteria)
 Execute a command on the logical server.
Task DeleteAsync (params object?[]? criteria)
 Called by a factory method in a business class or by the UI to delete an object.
ICslaObject 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.
ICslaObject 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.
ICslaObject Execute (ICslaObject obj)
 Called to execute a Command object on the server.
ICslaObject Execute (params object?[]? criteria)
 Execute a command on the logical server.
ICslaObject Update (ICslaObject obj)
 Insert, update or delete an object in the database.
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.

Detailed Description

Interface defining the members of the data portal type.

Member Function Documentation

◆ Create()

ICslaObject Csla.IDataPortal.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
criteriaObject-specific criteria.
Returns
A new object, populated with default values.

Implemented in Csla.DataPortal< T >.

◆ CreateAsync()

Task< ICslaObject > Csla.IDataPortal.CreateAsync ( params object??[] criteria)

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

Parameters
criteriaCriteria describing the object to create.

Implemented in Csla.DataPortal< T >.

◆ Delete()

void Csla.IDataPortal.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
criteriaObject-specific criteria.

Implemented in Csla.DataPortal< T >.

◆ DeleteAsync()

Task Csla.IDataPortal.DeleteAsync ( params object??[] criteria)

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

Parameters
criteriaObject-specific criteria.

Implemented in Csla.DataPortal< T >.

◆ Execute() [1/2]

ICslaObject Csla.IDataPortal.Execute ( ICslaObject 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
objA reference to the Command object to be executed.
Returns
A reference to the updated Command object.
Exceptions
ArgumentNullExceptionobj is null.

◆ Execute() [2/2]

ICslaObject Csla.IDataPortal.Execute ( params object??[] criteria)

Execute a command on the logical server.

Parameters
criteriaCriteria provided to the command object.
Returns
The resulting command object.

Implemented in Csla.DataPortal< T >.

◆ ExecuteAsync() [1/2]

Task< ICslaObject > Csla.IDataPortal.ExecuteAsync ( ICslaObject command)

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

Parameters
commandCommand object to execute.
Exceptions
ArgumentNullExceptioncommand is null.

◆ ExecuteAsync() [2/2]

Task< ICslaObject > Csla.IDataPortal.ExecuteAsync ( params object??[] criteria)

Execute a command on the logical server.

Parameters
criteriaCriteria provided to the command object.
Returns
The resulting command object.

Implemented in Csla.DataPortal< T >.

◆ Fetch()

ICslaObject Csla.IDataPortal.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
criteriaObject-specific criteria.
Returns
An object populated with values from the database.

Implemented in Csla.DataPortal< T >.

◆ FetchAsync()

Task< ICslaObject > Csla.IDataPortal.FetchAsync ( params object??[] criteria)

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

Parameters
criteriaCriteria describing the object to create.

Implemented in Csla.DataPortal< T >.

◆ Update()

ICslaObject Csla.IDataPortal.Update ( ICslaObject 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
objA reference to the business object to be updated.
Returns
A reference to the updated business object.
Exceptions
ArgumentNullExceptionobj is null.

◆ UpdateAsync()

Task< ICslaObject > Csla.IDataPortal.UpdateAsync ( ICslaObject obj)

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

Parameters
objObject to update.
Exceptions
ArgumentNullExceptionobj is null.

The documentation for this interface was generated from the following file: