IUserWriteSession Interface

Ingeniux CMS Content Store API

Represents a communication session used not only to retrieve objects from the content store, but also to create, delete, and modify objects. It is also the place to get all manager instances.

Namespace: Ingeniux.CMS
Assembly: Ingeniux.CMS.CSAPI (in Ingeniux.CMS.CSAPI.dll) Version: 9.0.565.0 (9.0.565)

Syntax

C++

Copy

public interface IUserWriteSession : IUserSession, 
	IManagersHost, IDisposable

Public Interface IUserWriteSession
	Inherits IUserSession, IManagersHost, IDisposable

public interface class IUserWriteSession : IUserSession, 
	IManagersHost, IDisposable

type IUserWriteSession =  
    interface
        interface IUserSession
        interface IManagersHost
        interface IDisposable
    end

The IUserWriteSession type exposes the following members.

Properties

	Name	Description
	AssetSecurityManager	Gets the manager of asset permissions. (Inherited from IManagersHost.)
	Closed	Checks if this session was already closed. (Inherited from IUserSession.)
	CompleteProgressOnClose	Gets/sets whether to complete the progress upon closing this session.
	ContentFreezeStartingTime	Gets the time when content freeze is about to start. Null if no content freeze looming. (Inherited from IUserSession.)
	GlobalExports	Gets the definition of exports that will be included as attributes in every link and navigation entry. (Inherited from IManagersHost.)
	GlobalVariables	Gets the collection of global variables. (Inherited from IManagersHost.)
	Id	Gets the unique ID of this session. (Inherited from IUserSession.)
	IP	The IP address this session was created for. Could be null if request is from http access (Inherited from IUserSession.)
	LingualMappingManager	Gets the manager of lingual maps between pages within a specific locale. (Inherited from IManagersHost.)
	LocalesManager	Gets the manager of built-in locales and custom locales. (Inherited from IManagersHost.)
	LoggingManager	Gets the manager of publishing logs and replication logs (Inherited from IManagersHost.)
	MobileDeviceManager	Gets the manager of device bundles for mobile preview emulation. (Inherited from IManagersHost.)
	OperatingUser	Gets the user who owns this session. (Inherited from IUserSession.)
	PageCreationRulesManager	Gets the manager of page creation rules. (Inherited from IManagersHost.)
	PCRDescriptorsManager	Gets the manager of site tree PCRs. (Inherited from IManagersHost.)
	PresentationsManager	Gets the presentations manager for managing presentation content units. (Inherited from IManagersHost.)
	Progress	Gets the progress report tracker
	PublishingManager	Gets the manager of publishing targets and publishing profiles (Inherited from IManagersHost.)
	ReferencesManager	Gets the manager of references between pages. (Inherited from IManagersHost.)
	SchemasManager	Gets the manager of schemas. (Inherited from IManagersHost.)
	SecurityDescriptorsManager	Gets the manager of site tree security. (Inherited from IManagersHost.)
	Settings	Gets the CMS settings collection. (Inherited from IManagersHost.)
	Site	Gets the manager of pages, page versions, and pages tree structure. (Inherited from IManagersHost.)
	SiteContentLocalizationProvider	Gets the manager of translations of page creation rules, schemas, workstates and workflow definitions. (Inherited from IManagersHost.)
	SiteMap	Gets the manager of branding types like sites and user agents (Inherited from IManagersHost.)
	StartTime	Gets the time that this session was opened. (Inherited from IUserSession.)
	TaxonomyManager	Gets the manager of category nodes as well as their structure. (Inherited from IManagersHost.)
	UserManager	Gets the manager of users, user groups, and group roles for custom permissions collections. (Inherited from IManagersHost.)
	WorkflowAdministrator	Gets the manager of workflow definitions, workstates, and workflows (Inherited from IManagersHost.)

Top

Methods

	Name	Description
	AddT	Adds a new object to the content store. Objects are saved to the content store upon session closure.
	CancelSaving	Prevents session from saving any changes.
	Commit	Manually saves changes to the content store.
	CompositeGetT, TManager	Retrieves an entity with given ID and objects related to the entity. The includeExpression defines what to include. (Inherited from IUserSession.)
	CompositeListT	Retrieves the collection of all objects of a given type as well as all objects related to the object type. The includeExpression defines what to include. (Inherited from IUserSession.)
	CountT	Gets the count of query results (Inherited from IUserSession.)
	DeleteT	Deletes an existing object from the content store. Deletion occurs upon session closure.
	DeleteByIds	Deletes existing objects by their object IDs.
	Exists	Checks whether an object with given unique ids exists or not (Inherited from IUserSession.)
	GetT	Retrieves an object that implements the IObjectWithId interface by its unique ID, from the content store. (Inherited from IUserSession.)
	GetEntitiesT, TManager	(Inherited from IUserSession.)
	GetEntityT, TManager	Retrieves by unique ID from the content store an entity object that implements the IEntityTManager interface. (Inherited from IUserSession.)
	GetManagerT	Retrieves an objec that IEntityTManager interface. (Inherited from IUserSession.)
	ListT	Retrieves the collection of all objects of a given type. (Inherited from IUserSession.)
	LuceneQueryAllT, TIndex	Queries the content store using Lucene query syntax, returning a collection of objects of the given type. The CSAPI creates indexes in the content store to expedite object lookup. The CSAPI comes with a set of indexes for its basic functionality. All strong-typed queries go through this method. Additional custom indexes can be created to provide further flexibility on fast lookup. Please refer to the Indexing topic for more information on indexes and custom indexes. (Inherited from IUserSession.)
	QueryT, TIndex	Queries the content store and returns a collection of objects of a given type. The query is based on the type of index provided. THe CSAPI creates indexes in the content store to expedite object lookup. CSAPI comes with a set of indexes for its basic functionality. All strong-typed queries go through this method. Additional custom indexes can be created to provide even further flexibilities on fast lookup. Please refer to the Indexing topic for more information on indexes and custom indexes. (Inherited from IUserSession.)

Top

Remarks

Objects retrieved within the session are only usable until the session is disposed. That means their methods don't work outside the session, their properties are not guaranteed to work outside the session.

UserSession objects are created from a persisting ContentStore object via the method OpenReadSession(IReadonlyUser). The best way to open and close a UserSession is with a "using" statement:

Examples

Copy

using (IUserWriteSession session = store.OpenWriteSession(currentUser))
{
    ...
}

Objects retrieved via UserWriteSession are automatically tracked for their changes. The changes are saved to the content store when the sesison is disposed. However, you can always manually perform saves via Commit method at any time.

If the objects are intended to be changed, use the UserWriteSession object.

Reference

Ingeniux.CMS Namespace

IContentStoreOpenWriteSession(IReadonlyUser)

Ingeniux.CMSIUserSession

Ingeniux.CMSITransactionalEntity

Ingeniux.CMSIUser