IUserSession Interface

Ingeniux CMS Content Store API

Represents a communication session used to retrieve objects from the content store. 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 IUserSession : IManagersHost, 
	IDisposable

Public Interface IUserSession
	Inherits IManagersHost, IDisposable

public interface class IUserSession : IManagersHost, 
	IDisposable

type IUserSession =  
    interface
        interface IManagersHost
        interface IDisposable
    end

The IUserSession 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.
	ContentFreezeStartingTime	Gets the time when content freeze is about to start. Null if no content freeze looming.
	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.
	IP	The IP address this session was created for. Could be null if request is from http access
	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.
	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.)
	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.
	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
	CompositeGetT, TManager	Retrieves an entity with given ID and objects related to the entity. The includeExpression defines what to include.
	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.
	CountT	Gets the count of query results
	Exists	Checks whether an object with given unique ids exists or not
	GetT	Retrieves an object that implements the IObjectWithId interface by its unique ID, from the content store.
	GetEntitiesT, TManager
	GetEntityT, TManager	Retrieves by unique ID from the content store an entity object that implements the IEntityTManager interface.
	GetManagerT	Retrieves an objec that IEntityTManager interface.
	ListT	Retrieves the collection of all objects of a given type.
	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.
	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.

Top

Exceptions

Exception	Condition
ArgumentException	When any objects retrieved within a read-only UserSession are modified.

Remarks

Objects retrieved within the session are only usable before the session is disposed. Their methods do not work outside the created session, and their properties are not guaranteed to work outside of the created session.

UserSessions are created from a persisting ContentStore object via the method OpenReadSession(IReadonlyUser). The best way to open a UserSession, and to make sure it is closed properly, is with a "using" statement:

Examples

Copy

using (IUserSession session = store.OpenReadSession(currentUser))
{
    ...
}

Objects retrieved via UserSession are read-only. An error is thrown upon closing the session if any of the objects were updated.

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

Reference

Ingeniux.CMS Namespace

IContentStoreOpenReadSession(IReadonlyUser)

Ingeniux.CMSIUserWriteSession

Ingeniux.CMSITransactionalEntity

Ingeniux.CMSIUser