Click or drag to resize

IReferencesManager Interface
Represents the manager object that provides a means to query and manage the Page cross references collection. The references system provides a different way to relate pages Pages in a nonorganized way. To relate pages in an organized way, the Taxonomy System is recommended solution.

Namespace: Ingeniux.CMS
Assembly: Ingeniux.CMS.CSAPI (in Ingeniux.CMS.CSAPI.dll) Version: 10.6.492
Syntax
Copy
public interface IReferencesManager : ITransactionalEntity, 
	IDisposable

The IReferencesManager type exposes the following members.

Properties
 NameDescription
Public propertyContentStore Gets the Content Store.
(Inherited from ITransactionalEntity)
Public propertyCurrentUser Gets the Operating User for the Session .
(Inherited from ITransactionalEntity)
Public propertySession Gets the User Session that this manager instance was initiated from.
(Inherited from ITransactionalEntity)
Top
Methods
 NameDescription
Public methodAddReference Adds a new reference between two Pages.
Public methodCount Gets the count of all Reference Entries stored on all Pages.
Public methodDeepCloneT, TManager Duplicates an object instance, not including its unique ID.
(Inherited from ITransactionalEntity)
Public methodGet Retrieves all References of the specified Page. This method can query recursively on references of referenced pages, with or without cross references.
Public methodQuickWrite Creates a temporary Write Session to quickly write something outside the current Session and transaction. This is a way to bypass the transaction and quickly put something into the content store.
(Inherited from ITransactionalEntity)
Public methodRemoveReference(IPage, IPage) Removes a Reference between two Pages.
Public methodRemoveReference(IPage, String) Removes a Reference between two Pages.
Public methodRemoveReferences Removes References from and/or to the specified Page.
Top
Remarks

Like all manager objects, instances of this manager are retrieved from an IUserSession object, and it only works within that session.

C#
Copy
using (IUserSession session = store.OpenReadSession(currentUser))
{
       IReferencesManager referencesManager = session.ReferencesManager;
       ...
}
Example
Serialization of this Manager object closely resembles the ReferencesMapping.xml file in CMS versions before CMS 9.0.
XML
Copy
<?xml version="1.0" encoding="UTF-8"?>
<ReferencesMapping LastUpdatedUser="ingeniux\admin1" LastUpdated="20140714T11:24:50">
  <Definitions>
    <Definition Description="The Reference" FullName="Reference" TagName="R" />
    <Definition Description="The source page XID" FullName="SourcePage" TagName="S" />
    <Definition Description="The target page XID" FullName="TargetPage" TagName="T" />
    <Definition Description="Last Updated Date" FullName="LastUpdatedDate" TagName="LUD" />
    <Definition Description="Last Update User" FullName="LastUpdateUser" TagName="LUU" />
  </Definitions>
  <References>
    <R S="x123" T="x345" LUU="ingeniux\admin2" LUD="20140714T10.24:01" />
    <R S="x6789" T="1011" LUU="ingeniux\admin3" LUD="20140714T10.41:43" />
  </References>
</ReferencesMapping>
See Also