Topics

All topics

Development

Query master and live versions

This article contains
NEW TO SITEFINITY?

When you query a content item, you can query its live or master version. This topic explains how to get each of these versions. The examples use the ID of the version as an argument. Because the master and the live versions have different unique IDs, the steps you take to get the desired version of the item depend on which of the IDs is passed as an argument. 

You can perform these actions by using either Native API or Fluent API. Therefore, the sections below provide code snippets for both APIs.

NOTE: In the following examples, news items will be used as content. However, the code applies to the following content types:

Query the live version by the master ID

The following code queries the live version of a content item by the ID of its master version.

Native API

using System;
using Telerik.Sitefinity.Modules.News;
using Telerik.Sitefinity.News.Model;
namespace SitefinityWebApp
{
public class QueryMasterLiveVersions_QueryingLiveVersionByMasterIDNativeAPI
{
private NewsItem QueryingLiveVersionByMasterIDNativeAPI(Guid masterId)
{
NewsManager manager = NewsManager.GetManager();
NewsItem master = manager.GetNewsItem(masterId);
NewsItem live = manager.Lifecycle.GetLive(master) as NewsItem;
return live;
}
}
}
view raw QueryMasterLiveVersions_QueryingLiveVersionByMasterIDNativeAPI.cs hosted with ❤ by GitHub

First, you get an instance of the manager. Then, you get the master version with the specified ID by calling the GetNewsItem method. Finally, to get the live version, you call Lifecycle.GetLive method with the master version as an argument.

NOTE: If an item with the specified masterId does not exist, the GetNewsItem method throws an ItemNotFoundException exception.

Fluent API

using System;
using Telerik.Sitefinity;
using Telerik.Sitefinity.News.Model;
namespace SitefinityWebApp
{
public class QueryMasterLiveVersions_QueryingLiveVersionByMasterIDFluentAPI
{
private NewsItem QueryingLiveVersionByMasterIDFluentAPI(Guid masterId)
{
return Telerik.Sitefinity.App.WorkWith().NewsItem(masterId).GetLive().Get();
}
}
}
view raw QueryMasterLiveVersions_QueryingLiveVersionByMasterIDFluentAPI.cs hosted with ❤ by GitHub

First, you get the singular facade of the master version with the specified ID. Then, to load the live version of the item, you call the GetLivemethod. Finally you call the Get method to get the instance of the live version.

Query the live version by ID

The following code queries the live version of a content item by the ID of the live version.

Native API

using System;
using Telerik.Sitefinity.Modules.News;
using Telerik.Sitefinity.News.Model;
namespace SitefinityWebApp
{
public class QueryMasterLiveVersions_QueryingLiveVersionByLiveIDNativeAPI
{
private NewsItem QueryingLiveVersionByLiveIDNativeAPI(Guid liveId)
{
NewsManager manager = NewsManager.GetManager();
NewsItem item = manager.GetNewsItem(liveId);
return item;
}
}
}
view raw QueryMasterLiveVersions_QueryingLiveVersionByLiveIDNativeAPI.cs hosted with ❤ by GitHub

First, you get an instance of the manager. Then, you get the version corresponding to the ID by calling the GetNewsItem method. This approach is also used, when you query the master version by its ID.

NOTE: If an item with the specified liveId does not exist, the GetNewsItem method throws an ItemNotFoundException exception.

Fluent API

using System;
using System.Linq;
using Telerik.Sitefinity;
using Telerik.Sitefinity.News.Model;
namespace SitefinityWebApp
{
public class QueryMasterLiveVersions_QueryingLiveVersionByLiveIDFluentAPI
{
private NewsItem QueryingLiveVersionByLiveIDFluentAPI(Guid liveId)
{
return App.WorkWith().NewsItems().Where(item => item.Id == liveId).Get().SingleOrDefault();
}
}
}
view raw QueryMasterLiveVersions_QueryingLiveVersionByLiveIDFluentAPI.cs hosted with ❤ by GitHub

First, you get the plural facade. Then, you filter the collection to get the item with the corresponding ID.

NOTE: The singular facades for the different content types work only with the master version of the items. If you want to use the ID of the live version, you must use the plural facade for the respective content type and filter the collection, as explained above.

Query the master version by ID

The following code queries the master version of a content item by the ID of the master version.

Native API

using System;
using Telerik.Sitefinity.Modules.News;
using Telerik.Sitefinity.News.Model;
namespace SitefinityWebApp
{
public class QueryMasterLiveVersions_QueryingMasterVersionByMasterIDNativeAPI
{
private NewsItem QueryingMasterVersionByMasterIDNativeAPI(Guid masterId)
{
NewsManager manager = NewsManager.GetManager();
NewsItem item = manager.GetNewsItem(masterId);
return item;
}
}
}
view raw QueryMasterLiveVersions_QueryingMasterVersionByMasterIDNativeAPI.cs hosted with ❤ by GitHub

First, you get an instance of the manager. Then, you get the version with the specified ID by calling the GetNewsItem method. This approach is also used, when you query the live version by its ID.

NOTE: If an item with the specified masterId does not exist, the GetNewsItem method throws an ItemNotFoundException exception.

Fluent API

using System;
using Telerik.Sitefinity;
using Telerik.Sitefinity.News.Model;
namespace SitefinityWebApp
{
public class QueryMasterLiveVersions_QueryingMasterVersionByMasterIDFluentAPI_
{
private NewsItem QueryingMasterVersionByMasterIDFluentAPI(Guid masterId)
{
return App.WorkWith().NewsItem(masterId).Get();
}
}
}
view raw QueryMasterLiveVersions_QueryingMasterVersionByMasterIDFluentAPI_.cs hosted with ❤ by GitHub

First, you get the NewsItems singular facade of the item with specified ID. Finally, to obtain an instance of the item, you call the Get method of the facade.

NOTE: The singular facades for the different content types work only with the master version of the items.

Query the master version by the live ID

The following code queries the master version of a content item by the ID of its live version.

Native API

using System;
using Telerik.Sitefinity.Modules.News;
using Telerik.Sitefinity.News.Model;
namespace SitefinityWebApp
{
public class QueryMasterLiveVersions_QueryingMasterVersionByLiveIDNativeAPI
{
private NewsItem QueryingMasterVersionByLiveIDNativeAPI(Guid liveId)
{
NewsManager manager = NewsManager.GetManager();
NewsItem live = manager.GetNewsItem(liveId);
NewsItem master = manager.Lifecycle.GetMaster(live) as NewsItem;
return master;
}
}
}
view raw QueryMasterLiveVersions_QueryingMasterVersionByLiveIDNativeAPI.cs hosted with ❤ by GitHub

First, you get an instance of the manager. Then, you get the version of the item corresponding to the ID by calling the GetNewsItem method. Finally, you call Lifecycle.GetMaster with the live version as an argument.

NOTE: If an item with the specified liveId does not exist, the GetNewsItem method throws an ItemNotFoundException exception.

Fluent API

using System;
using System.Linq;
using Telerik.Sitefinity;
using Telerik.Sitefinity.News.Model;
namespace SitefinityWebApp
{
public class QueryMasterLiveVersions_QueryingMasterVersionByLiveIDFluentAPI
{
private NewsItem QueryingMasterVersionByLiveIDFluentAPI(Guid liveId)
{
NewsItem master = null;
NewsItem live = App.WorkWith().NewsItems().Where(item => item.Id == liveId).Get().SingleOrDefault();
if (live != null)
{
master = App.WorkWith().NewsItem().GetManager().GetMaster(live);
}
return master;
}
}
}
view raw QueryMasterLiveVersions_QueryingMasterVersionByLiveIDFluentAPI.cs hosted with ❤ by GitHub

First, you get an instance of the live version of the item corresponding to the ID. Then, you get the master version of the item using the instance of the NewsManager exposed by the news item facade.

Handle all scenarios with one method

The following code handles all the scenarios described above. The method accepts the ID of either the live or the master version and the type of the version that must be returned.

Native API

using System;
using Telerik.Sitefinity.GenericContent.Model;
using Telerik.Sitefinity.Modules.News;
using Telerik.Sitefinity.News.Model;
namespace SitefinityWebApp
{
public class QueryMasterLiveVersions_QueryingContentNativeAPI
{
private NewsItem QueryingContentNativeAPI(Guid itemId, ContentLifecycleStatus status)
{
NewsManager manager = NewsManager.GetManager();
NewsItem item = manager.GetNewsItem(itemId);
if (item.Status != status)
{
if (item.Status == ContentLifecycleStatus.Live && status == ContentLifecycleStatus.Master)
{
item = manager.Lifecycle.GetMaster(item) as NewsItem;
}
else if (item.Status == ContentLifecycleStatus.Master && status == ContentLifecycleStatus.Live)
{
item = manager.Lifecycle.GetLive(item) as NewsItem;
}
else
{
//Temp versions of an item must be used only when modifying the item!
return null;
}
}
return item;
}
}
}
view raw QueryMasterLiveVersions_QueryingContentNativeAPI.cs hosted with ❤ by GitHub

First, you get an instance of the manager. Then, you get the version of the item with the specified ID by calling the GetNewsItem method. Then, if the status of the item is different from the status argument, you get the version with the desired status. Note that the temp versions of the item are not handled here. You must work with them only when editing an item.

NOTE: If an item with the specified itemId does not exist, the GetNewsItem method throws an ItemNotFoundException exception.

Fluent API

using System;
using System.Linq;
using Telerik.Sitefinity;
using Telerik.Sitefinity.GenericContent.Model;
using Telerik.Sitefinity.News.Model;
namespace SitefinityWebApp
{
public class QueryMasterLiveVersions_QueryingContentFluentAPI
{
private NewsItem QueryingContentFluentAPI(Guid itemId, ContentLifecycleStatus status)
{
NewsItem item = App.WorkWith().NewsItems().Where(newsItem => newsItem.Id == itemId).Get().SingleOrDefault();
if (item != null)
{
if (item.Status != status)
{
if (item.Status == ContentLifecycleStatus.Live && status == ContentLifecycleStatus.Master)
{
item = App.WorkWith().NewsItem().GetManager().GetMaster(item);
}
else if (item.Status == ContentLifecycleStatus.Master && status == ContentLifecycleStatus.Live)
{
item = App.WorkWith().NewsItem().GetManager().GetLive(item);
}
else
{
//Temp versions of an item must be used only when modifying the item!
return null;
}
}
}
return item;
}
}
}
view raw QueryMasterLiveVersions_QueryingContentFluentAPI.cs hosted with ❤ by GitHub

First, you get an instance of the version of the item with the specified ID using the plural facade. This way the code does not depend on whether the ID belongs to the live or the master version of the item. Then, if the status of the item is different from the status argument, you get the version with the desired status. Note that the temp versions of the item are not handled here. You must work with them only when editing an item.

Query all items of a content type

The following code queries all news items with the specified status.

Native API

using System.Collections.Generic;
using System.Linq;
using Telerik.Sitefinity.GenericContent.Model;
using Telerik.Sitefinity.Modules.News;
using Telerik.Sitefinity.News.Model;
namespace SitefinityWebApp
{
public class QueryMasterLiveVersions_QueryingAllItemsNativeAPI
{
private List<NewsItem> QueryingAllItemsNativeAPI(ContentLifecycleStatus status)
{
NewsManager manager = NewsManager.GetManager();
return manager.GetNewsItems().Where(item => item.Status == status).ToList();
}
}
}
view raw QueryMasterLiveVersions_QueryingAllItemsNativeAPI.cs hosted with ❤ by GitHub

First, you get an instance of the manager. Then, you get all news items and filter them to return only the items with the specified status.

Fluent API

using System.Collections.Generic;
using System.Linq;
using Telerik.Sitefinity;
using Telerik.Sitefinity.GenericContent.Model;
using Telerik.Sitefinity.News.Model;
namespace SitefinityWebApp
{
public class QueryMasterLiveVersions_QueryingAllItemsFluentAPI
{
private List<NewsItem> QueryingAllItemsFluentAPI(ContentLifecycleStatus status)
{
return Telerik.Sitefinity.App.WorkWith().NewsItems().Where(item => item.Status == status).Get().ToList();
}
}
}
view raw QueryMasterLiveVersions_QueryingAllItemsFluentAPI.cs hosted with ❤ by GitHub

First, you get all items via the plural facade. Then, you filter them to return only the items with the specified status.

Want to learn more?

Increase your Sitefinity skills by signing up for our free trainings. Get Sitefinity-certified at Progress Education Community to boost your credentials.

Get started with Integration Hub | Sitefinity Cloud | Sitefinity SaaS

This free lesson teaches administrators, marketers, and other business professionals how to use the Integration hub service to create automated workflows between Sitefinity and other business systems.

Web Security for Sitefinity Administrators

This free lesson teaches administrators the basics about protecting yor Sitefinity instance and its sites from external threats. Configure HTTPS, SSL, allow lists for trusted sites, and cookie security, among others.

Foundations of Sitefinity ASP.NET Core Development

The free on-demand video course teaches developers how to use Sitefinity .NET Core and leverage its decoupled architecture and new way of coding against the platform.

Was this article helpful?

Next article

Edit content