TransactionBase Class

Abstract transaction class which is used to control a serie of actions on multiple entities or entity collection classes. The database connection is opened in the constructor, so the transaction instance is ready to use. This class is the non-COM+ version, it will always start a new ADO.NET transaction and will not be using a COM+ transaction when callers are participating in such a transaction.

Inheritance Hierarchy

SystemObject
SD.LLBLGen.Pro.ORMSupportClassesTransactionBase

Namespace: SD.LLBLGen.Pro.ORMSupportClasses
Assembly: SD.LLBLGen.Pro.ORMSupportClasses (in SD.LLBLGen.Pro.ORMSupportClasses.dll) Version: 5.9.0.0 (5.9.0)

Syntax

Copy

public abstract class TransactionBase : ITransaction, 
	ITransactionController, IDisposable

Public MustInherit Class TransactionBase
	Implements ITransaction, ITransactionController, IDisposable

The TransactionBase type exposes the following members.

Constructors

	Name	Description
	TransactionBase(String)	Ctor, used in adapter situations where the transaction is started later on.
	TransactionBase(IsolationLevel, String)	CTor. Will read the connection string from an external source.
	TransactionBase(IsolationLevel, String, String)	CTor.
	TransactionBase(IsolationLevel, String, String, Boolean, Boolean)	CTor.

Top

Properties

	Name	Description
	ConnectionString	Gets the connection string used for the connection with the database. Only settable with the constructor.
	ConnectionToUse	The connection object to use with this transaction.
	EntitiesInTransaction	List of GUID's of the entities currently participating in this transaction. This collection is used to keep track of which entities already have been added during a recursive save.
	InSystemTransaction	Gets a value indicating whether a System.Transactions transaction is going on. If not, false is returned.
	Name	Gets the name of the transaction. Only settable with the constructor.
	PhysicalTransaction	The physical transaction object used over ConnectionToUse.
	TransactionIsolationLevel	Gets the isolation level the transaction should use. Only settable with the constructor.

Top

Methods

	Name	Description
	Add	Adds the passed in object as a participant of this transaction.
	AddAuditor	Adds the auditor passed in to the set of auditors to get audit entities from at commit.
	AssureConnectionIsPresent	Makes sure there's an active DbConnection object ready to be used. It doesn't open the connection yet, it only makes sure the connection object is there.
	CloseConnection	Close the active connection, if it's open.
	Commit	Commits the transaction in action. It will end all database activity, since commiting a transaction is finalizing it. After calling Commit or Rollback, the ITransaction implementing class will reset itself.
	CommitAsync	Async variant of Commit. Commits the transaction in action. It will end all database activity, since commiting a transaction is finalizing it. After calling Commit or Rollback, the ITransaction implementing class will reset itself.
	CreateConnection	Creates a new DbConnection instance which will be used by all elements using this ITransaction instance. Reads connectionstring from .config file.
	CreateConnection(String)	Creates a new DbConnection instance which will be used by all elements using this ITransaction instance
	CreatePhysicalTransaction	Creates a new physical transaction object over the created connection. The connection is assumed to be open.
	Dispose	Implements the IDispose' method Dispose.
	Dispose(Boolean)	Implements the Dispose functionality.
	Equals	Determines whether the specified object is equal to the current object. (Inherited from Object.)
	Finalize	Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
	GatherEntitiesFromAuditorsToFlush	Will gather all entities to flush in the current transaction from auditors which have created these entities and store them in the container specified.
	GetHashCode	Serves as the default hash function. (Inherited from Object.)
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	MemberwiseClone	Creates a shallow copy of the current Object. (Inherited from Object.)
	OnBeforeCommit	Called right before the physical transaction is committed.
	OnBeforeRollback	Called right before the physical transaction is rolled back.
	OpenConnection	Opens the contained connection if it's not alraedy open
	OpenConnectionAsync	Async variant of OpenConnection
	Remove	Removes the passed in object from the transaction.
	Reset	Resets the transaction object. All participants will be notified.
	Rollback	Rolls back the transaction in action. It will end all database activity, since commiting a transaction is finalizing it. After calling Commit or Rollback, the ITransaction implementing class will reset itself.
	Rollback(String)	Rolls back the transaction in action to the savepoint with the name savepointName. No internal objects are being reset when this method is called, so call this Rollback overload only to roll back to a savepoint. To roll back a complete transaction, call Rollback() without specifying a savepoint name. Create a savepoint by calling Save(savePointName)
	Save	Creates a savepoint with the name savePointName in the current transaction. You can roll back to this savepoint using Rollback(String).
	Start	Starts the transaction if it hasn't been started yet.
	StartAsync	Starts the transaction if it hasn't been started yet.
	ToString	Returns a string that represents the current object. (Inherited from Object.)

Top

Events

	Name	Description
	TransactionCommitted	Raised when Commit was successful.
	TransactionRolledback	Raised when Rollback was successful.

Top

Explicit Interface Implementations

	Name	Description
	ITransactionControllerIsTransactionInProgress	Gets IsTransactionInProgress. True when there is a transaction in progress.

Top

Reference

SD.LLBLGen.Pro.ORMSupportClasses Namespace