Sitefinity CMS provides you with an API for managing related items using the RelatedDataExtensions public class. The API consists of extension methods over object items (facilitates the use of the API in widget templates) and over IDataItem for creating and deleting item relations.
NOTE: When using with the related data API, you need to work with the master versions of both the related data item and the item, to which you are creating a relation.
You can create content item relations using the following methods:
You can delete item relations using the following methods:
The following code demonstrates how to create item relations:
var providerName = String.Empty;
DynamicModuleManager dynamicModuleManager = DynamicModuleManager.GetManager(providerName);
Type locationType = TypeResolutionService.ResolveType(
var location = dynamicModuleManager.GetDataItems(locationType) .FirstOrDefault(t=>t.Status == ContentLifecycleStatus.Master)
Type sessionType = TypeResolutionService.ResolveType(
var session = dynamicModuleManager.GetDataItems(sessionType) .FirstOrDefault(t=>t.Status == ContentLifecycleStatus.Master);
&& session !=
// create a relation to location. Relation will be available only for the current session item state (Master)
// on publish, all item's relations are copied from Master to Live availability.
In addition, you can delete the relation between the session and the location you created above using the following code:
// delete the relation between the session item and the location
session.DeleteRelation (location, “Location”);
You can retrieve all related child items of particular field using the following methods:
All parent items, of particular item, can be retrieved via the following methods:
NOTE: The returned result contains a list with all related data items. The data items are in the same status as the related item, whose child or a parent they are.
Improvinged Related Data Performance
The Related Data API performance has been improved. For example, when you try to retrieve the related data items for specific collection of items, you set this collection to the context and after the first related item is requested, Sitefinity loads all the related data items per property for this collection. After this, each time a request for the related data items from the API is made, Sitefinity returns the results for them from the context (and not from the provider).
void SetRelatedDataSourceContext(this IEnumerable<IDataItem> items)
Sets a collection of items to the context. This collection is then used to retrieve the related data items per field as soon as the first item from this collection requests its related data items.
Back To Top