Get the default location of an item
You can get an item's default location by using the overloads of GetItemDefaultLocation method in one of the following ways.
PREREQUISITES: The default location of an item must be a page that is accessible by all users, that is, they have permissions to view it.
Get the default location of an item by its details
To do this, you use the GetItemDefaultLocation(Type itemType, string itemProvider, Guid itemId, CultureInfo culture = null) overload.
This overload gets the default (canonical) location by specifying the item type, the item’s provider, and the item ID. This method is useful when you have no reference to the actual content item. It returns an IContentItemLocation item that contains the following information:
- The absolute URL of the item
- The
PageIdwhere the item can be opened - The
SiteId, which is the ID of the site which the page belongs to. - The
IsDefaultBoolean flag that is set to true, indicating that this a default location.
If there is no location where an item can be opened, the method returns null.
The following code sample gets the default location of a news item:
using System;
using Telerik.Sitefinity.News.Model;
using Telerik.Sitefinity.Services;
namespace Telerik.Sitefinity.Documentation.CodeSnippets.DevGuide.HowTo.ContentLocationsAPI
{
public partial class ContentLocationsAPI
{
public static string GetItemDefaultLocationById(Guid itemId, string itemProvider = null)
{
//first we need to get an instance of the location service
var clService = SystemManager.GetContentLocationService();
//gets the item default location of a given item by itemId provided
var location = clService.GetItemDefaultLocation(
typeof(NewsItem),
itemProvider,
itemId);
//gets the absolute url for the location
if (location != null)
return location.ItemAbsoluteUrl;
return string.Empty;
}
}
}
Get the default location of an item by a reference
To do this, you use the GetItemDefaultLocation(IDataItem item, CultureInfo culture = null) overload.
This overload gets the default (canonical) location of type IContentItemLocation, where the specified IDataItem can be opened. This method can be used when there is a reference to the actual content item. It returns an IContentItemLocation item or null if there is no location for item of that type, provider, and language (for multilingual).
The following code sample gets the default location of a news item:
using Telerik.Sitefinity.News.Model;
using Telerik.Sitefinity.Services;
namespace Telerik.Sitefinity.Documentation.CodeSnippets.DevGuide.HowTo.ContentLocationsAPI
{
public partial class ContentLocationsAPI
{
public static string GetItemDefaultLocation(NewsItem item)
{
//first we need to get an instance of the location service
var clService = SystemManager.GetContentLocationService();
//gets the item default location of a given news item
var location = clService.GetItemDefaultLocation(item);
//gets the absolute url for the location
if (location != null)
return location.ItemAbsoluteUrl;
return string.Empty;
}
}
}
