Class UmbracoHelper

A helper class that provides many useful methods and functionality for using Umbraco in templates

Inheritance

System.Object

Namespace: Umbraco.Web

Assembly: Umbraco.Web.dll

Syntax

public class UmbracoHelper

Remarks

This object is a request based lifetime

Constructors

View Source

UmbracoHelper(IPublishedContent, ITagQuery, ICultureDictionaryFactory, IUmbracoComponentRenderer, IPublishedContentQuery, MembershipHelper)

Initializes a new instance of UmbracoHelper.

Declaration

public UmbracoHelper(IPublishedContent currentPage, ITagQuery tagQuery, ICultureDictionaryFactory cultureDictionary, IUmbracoComponentRenderer componentRenderer, IPublishedContentQuery publishedContentQuery, MembershipHelper membershipHelper)

Parameters

Type	Name	Description
IPublishedContent	currentPage	The IPublishedContent item assigned to the helper.
ITagQuery	tagQuery
ICultureDictionaryFactory	cultureDictionary
IUmbracoComponentRenderer	componentRenderer
IPublishedContentQuery	publishedContentQuery
MembershipHelper	membershipHelper

Remarks

Sets the current page to the context's published content request's content item.

Properties

View Source

AssignedContentItem

Gets (or sets) the current IPublishedContent item assigned to the UmbracoHelper.

Declaration

public IPublishedContent AssignedContentItem { get; set; }

Property Value

Type	Description
IPublishedContent

Remarks

Note that this is the assigned IPublishedContent item to the UmbracoHelper, this is not necessarily the Current IPublishedContent item being rendered that is assigned to the UmbracoContext. This IPublishedContent object is contextual to the current UmbracoHelper instance.

In some cases accessing this property will throw an exception if there is not IPublishedContent assigned to the Helper this will only ever happen if the Helper is constructed via DI during a non front-end request.

Exceptions

Type	Condition
System.InvalidOperationException	Thrown if the UmbracoHelper is constructed with an UmbracoContext and it is not a front-end request.

View Source

ContentQuery

Gets the query context.

Declaration

[Obsolete("Inject and use an instance of IPublishedContentQuery in the constructor for using it in classes or get it from Current.PublishedContentQuery in views")]
public IPublishedContentQuery ContentQuery { get; }

Property Value

Type	Description
IPublishedContentQuery

View Source

CultureDictionary

Returns the ICultureDictionary for access to dictionary items

Declaration

public ICultureDictionary CultureDictionary { get; }

Property Value

Type	Description
ICultureDictionary

View Source

MembershipHelper

Gets the membership helper.

Declaration

[Obsolete("Inject and use an instance of MembershipHelper in the constructor instead. In views you can use @Members.")]
public MembershipHelper MembershipHelper { get; }

Property Value

Type	Description
MembershipHelper

View Source

TagQuery

Gets the tag context.

Declaration

[Obsolete("Inject and use an instance of ITagQuery in the constructor for using it in classes or get it from Current.TagQuery in views.")]
public ITagQuery TagQuery { get; }

Property Value

Type	Description
ITagQuery

Methods

View Source

Content(IEnumerable<Int32>)

Gets the contents corresponding to the identifiers.

Declaration

public IEnumerable<IPublishedContent> Content(IEnumerable<int> ids)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<System.Int32>	ids	The content identifiers.

Returns

Type	Description
System.Collections.Generic.IEnumerable<IPublishedContent>	The existing contents corresponding to the identifiers.

Remarks

If an identifier does not match an existing content, it will be missing in the returned value.

View Source

Content(IEnumerable<Object>)

Gets the contents corresponding to the identifiers.

Declaration

public IEnumerable<IPublishedContent> Content(IEnumerable<object> ids)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<System.Object>	ids	The content identifiers.

Returns

Type	Description
System.Collections.Generic.IEnumerable<IPublishedContent>	The existing contents corresponding to the identifiers.

Remarks

If an identifier does not match an existing content, it will be missing in the returned value.

View Source

Content(IEnumerable<String>)

Gets the contents corresponding to the identifiers.

Declaration

public IEnumerable<IPublishedContent> Content(IEnumerable<string> ids)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<System.String>	ids	The content identifiers.

Returns

Type	Description
System.Collections.Generic.IEnumerable<IPublishedContent>	The existing contents corresponding to the identifiers.

Remarks

If an identifier does not match an existing content, it will be missing in the returned value.

View Source

Content(IEnumerable<GuidUdi>)

Gets the contents corresponding to the identifiers.

Declaration

public IEnumerable<IPublishedContent> Content(IEnumerable<GuidUdi> ids)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<GuidUdi>	ids	The content identifiers.

Returns

Type	Description
System.Collections.Generic.IEnumerable<IPublishedContent>	The existing contents corresponding to the identifiers.

Remarks

If an identifier does not match an existing content, it will be missing in the returned value.

View Source

Content(IEnumerable<Udi>)

Gets the contents corresponding to the identifiers.

Declaration

public IEnumerable<IPublishedContent> Content(IEnumerable<Udi> ids)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<Udi>	ids	The content identifiers.

Returns

Type	Description
System.Collections.Generic.IEnumerable<IPublishedContent>	The existing contents corresponding to the identifiers.

Remarks

If an identifier does not match an existing content, it will be missing in the returned value.

View Source

Content(Guid)

Gets a content item from the cache.

Declaration

public IPublishedContent Content(Guid id)

Parameters

Type	Name	Description
System.Guid	id	The key of the content item.

Returns

Type	Description
IPublishedContent	The content, or null of the content item is not in the cache.

View Source

Content(Guid[])

Gets content items from the cache.

Declaration

public IEnumerable<IPublishedContent> Content(params Guid[] ids)

Parameters

Type	Name	Description
System.Guid[]	ids	The keys of the content items.

Returns

Type	Description
System.Collections.Generic.IEnumerable<IPublishedContent>	The content items that were found in the cache.

View Source

Content(Int32)

Gets a content item from the cache.

Declaration

public IPublishedContent Content(int id)

Parameters

Type	Name	Description
System.Int32	id	The unique identifier of the content item.

Returns

Type	Description
IPublishedContent	The content, or null of the content item is not in the cache.

View Source

Content(Int32[])

Gets content items from the cache.

Declaration

public IEnumerable<IPublishedContent> Content(params int[] ids)

Parameters

Type	Name	Description
System.Int32[]	ids	The unique identifiers of the content items.

Returns

Type	Description
System.Collections.Generic.IEnumerable<IPublishedContent>	The content items that were found in the cache.

View Source

Content(Object)

Gets a content item from the cache.

Declaration

public IPublishedContent Content(object id)

Parameters

Type	Name	Description
System.Object	id	The unique identifier, or the key, of the content item.

Returns

Type	Description
IPublishedContent	The content, or null of the content item is not in the cache.

View Source

Content(Object[])

Gets content items from the cache.

Declaration

public IEnumerable<IPublishedContent> Content(params object[] ids)

Parameters

Type	Name	Description
System.Object[]	ids	The unique identifiers, or the keys, of the content items.

Returns

Type	Description
System.Collections.Generic.IEnumerable<IPublishedContent>	The content items that were found in the cache.

Remarks

Does not support mixing identifiers and keys.

View Source

Content(String)

Gets a content item from the cache.

Declaration

public IPublishedContent Content(string id)

Parameters

Type	Name	Description
System.String	id	The unique identifier, or the key, of the content item.

Returns

Type	Description
IPublishedContent	The content, or null of the content item is not in the cache.

View Source

Content(String[])

Gets content items from the cache.

Declaration

public IEnumerable<IPublishedContent> Content(params string[] ids)

Parameters

Type	Name	Description
System.String[]	ids	The unique identifiers, or the keys, of the content items.

Returns

Type	Description
System.Collections.Generic.IEnumerable<IPublishedContent>	The content items that were found in the cache.

Remarks

Does not support mixing identifiers and keys.

View Source

Content(GuidUdi[])

Gets the contents corresponding to the identifiers.

Declaration

public IEnumerable<IPublishedContent> Content(params GuidUdi[] ids)

Parameters

Type	Name	Description
GuidUdi[]	ids	The content identifiers.

Returns

Type	Description
System.Collections.Generic.IEnumerable<IPublishedContent>	The existing contents corresponding to the identifiers.

Remarks

If an identifier does not match an existing content, it will be missing in the returned value.

View Source

Content(Udi)

Declaration

public IPublishedContent Content(Udi id)

Parameters

Type	Name	Description
Udi	id

Returns

Type	Description
IPublishedContent

View Source

Content(Udi[])

Gets the contents corresponding to the identifiers.

Declaration

public IEnumerable<IPublishedContent> Content(params Udi[] ids)

Parameters

Type	Name	Description
Udi[]	ids	The content identifiers.

Returns

Type	Description
System.Collections.Generic.IEnumerable<IPublishedContent>	The existing contents corresponding to the identifiers.

Remarks

If an identifier does not match an existing content, it will be missing in the returned value.

View Source

ContentAtRoot()

Declaration

public IEnumerable<IPublishedContent> ContentAtRoot()

Returns

Type	Description
System.Collections.Generic.IEnumerable<IPublishedContent>

View Source

ContentAtXPath(String, XPathVariable[])

Declaration

public IEnumerable<IPublishedContent> ContentAtXPath(string xpath, params XPathVariable[] vars)

Parameters

Type	Name	Description
System.String	xpath
XPathVariable[]	vars

Returns

Type	Description
System.Collections.Generic.IEnumerable<IPublishedContent>

View Source

ContentAtXPath(XPathExpression, XPathVariable[])

Declaration

public IEnumerable<IPublishedContent> ContentAtXPath(XPathExpression xpath, params XPathVariable[] vars)

Parameters

Type	Name	Description
System.Xml.XPath.XPathExpression	xpath
XPathVariable[]	vars

Returns

Type	Description
System.Collections.Generic.IEnumerable<IPublishedContent>

View Source

ContentSingleAtXPath(String, XPathVariable[])

Declaration

public IPublishedContent ContentSingleAtXPath(string xpath, params XPathVariable[] vars)

Parameters

Type	Name	Description
System.String	xpath
XPathVariable[]	vars

Returns

Type	Description
IPublishedContent

View Source

GetDictionaryValue(String)

Returns the dictionary value for the key specified

Declaration

public string GetDictionaryValue(string key)

Parameters

Type	Name	Description
System.String	key

Returns

Type	Description
System.String

View Source

GetDictionaryValue(String, String)

Returns the dictionary value for the key specified, and if empty returns the specified default fall back value

Declaration

public string GetDictionaryValue(string key, string altText)

Parameters

Type	Name	Description
System.String	key	key of dictionary item
System.String	altText	fall back text if dictionary item is empty - Name altText to match Umbraco.Field

Returns

Type	Description
System.String

View Source

Media(IEnumerable<Int32>)

Gets the medias corresponding to the identifiers.

Declaration

public IEnumerable<IPublishedContent> Media(IEnumerable<int> ids)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<System.Int32>	ids	The media identifiers.

Returns

Type	Description
System.Collections.Generic.IEnumerable<IPublishedContent>	The existing medias corresponding to the identifiers.

Remarks

If an identifier does not match an existing media, it will be missing in the returned value.

View Source

Media(IEnumerable<Object>)

Gets the medias corresponding to the identifiers.

Declaration

public IEnumerable<IPublishedContent> Media(IEnumerable<object> ids)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<System.Object>	ids	The media identifiers.

Returns

Type	Description
System.Collections.Generic.IEnumerable<IPublishedContent>	The existing medias corresponding to the identifiers.

Remarks

If an identifier does not match an existing media, it will be missing in the returned value.

View Source

Media(IEnumerable<String>)

Gets the medias corresponding to the identifiers.

Declaration

public IEnumerable<IPublishedContent> Media(IEnumerable<string> ids)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<System.String>	ids	The media identifiers.

Returns

Type	Description
System.Collections.Generic.IEnumerable<IPublishedContent>	The existing medias corresponding to the identifiers.

Remarks

If an identifier does not match an existing media, it will be missing in the returned value.

View Source

Media(IEnumerable<GuidUdi>)

Gets the medias corresponding to the identifiers.

Declaration

public IEnumerable<IPublishedContent> Media(IEnumerable<GuidUdi> ids)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<GuidUdi>	ids	The media identifiers.

Returns

Type	Description
System.Collections.Generic.IEnumerable<IPublishedContent>	The existing medias corresponding to the identifiers.

Remarks

If an identifier does not match an existing media, it will be missing in the returned value.

View Source

Media(IEnumerable<Udi>)

Gets the medias corresponding to the identifiers.

Declaration

public IEnumerable<IPublishedContent> Media(IEnumerable<Udi> ids)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<Udi>	ids	The media identifiers.

Returns

Type	Description
System.Collections.Generic.IEnumerable<IPublishedContent>	The existing medias corresponding to the identifiers.

Remarks

If an identifier does not match an existing media, it will be missing in the returned value.

View Source

Media(Guid)

Declaration

public IPublishedContent Media(Guid id)

Parameters

Type	Name	Description
System.Guid	id

Returns

Type	Description
IPublishedContent

View Source

Media(Int32)

Declaration

public IPublishedContent Media(int id)

Parameters

Type	Name	Description
System.Int32	id

Returns

Type	Description
IPublishedContent

View Source

Media(Int32[])

Gets the medias corresponding to the identifiers.

Declaration

public IEnumerable<IPublishedContent> Media(params int[] ids)

Parameters

Type	Name	Description
System.Int32[]	ids	The media identifiers.

Returns

Type	Description
System.Collections.Generic.IEnumerable<IPublishedContent>	The existing medias corresponding to the identifiers.

Remarks

If an identifier does not match an existing media, it will be missing in the returned value.

View Source

Media(Object)

Overloaded method accepting an 'object' type

Declaration

public IPublishedContent Media(object id)

Parameters

Type	Name	Description
System.Object	id

Returns

Type	Description
IPublishedContent

Remarks

We accept an object type because GetPropertyValue now returns an 'object', we still want to allow people to pass this result in to this method. This method will throw an exception if the value is not of type int or string.

View Source

Media(Object[])

Gets the medias corresponding to the identifiers.

Declaration

public IEnumerable<IPublishedContent> Media(params object[] ids)

Parameters

Type	Name	Description
System.Object[]	ids	The media identifiers.

Returns

Type	Description
System.Collections.Generic.IEnumerable<IPublishedContent>	The existing medias corresponding to the identifiers.

Remarks

If an identifier does not match an existing media, it will be missing in the returned value.

View Source

Media(String)

Declaration

public IPublishedContent Media(string id)

Parameters

Type	Name	Description
System.String	id

Returns

Type	Description
IPublishedContent

View Source

Media(String[])

Gets the medias corresponding to the identifiers.

Declaration

public IEnumerable<IPublishedContent> Media(params string[] ids)

Parameters

Type	Name	Description
System.String[]	ids	The media identifiers.

Returns

Type	Description
System.Collections.Generic.IEnumerable<IPublishedContent>	The existing medias corresponding to the identifiers.

Remarks

If an identifier does not match an existing media, it will be missing in the returned value.

View Source

Media(GuidUdi[])

Gets the medias corresponding to the identifiers.

Declaration

public IEnumerable<IPublishedContent> Media(params GuidUdi[] ids)

Parameters

Type	Name	Description
GuidUdi[]	ids	The media identifiers.

Returns

Type	Description
System.Collections.Generic.IEnumerable<IPublishedContent>	The existing medias corresponding to the identifiers.

Remarks

If an identifier does not match an existing media, it will be missing in the returned value.

View Source

Media(Udi)

Declaration

public IPublishedContent Media(Udi id)

Parameters

Type	Name	Description
Udi	id

Returns

Type	Description
IPublishedContent

View Source

Media(Udi[])

Gets the medias corresponding to the identifiers.

Declaration

public IEnumerable<IPublishedContent> Media(params Udi[] ids)

Parameters

Type	Name	Description
Udi[]	ids	The media identifiers.

Returns

Type	Description
System.Collections.Generic.IEnumerable<IPublishedContent>	The existing medias corresponding to the identifiers.

Remarks

If an identifier does not match an existing media, it will be missing in the returned value.

View Source

MediaAtRoot()

Declaration

public IEnumerable<IPublishedContent> MediaAtRoot()

Returns

Type	Description
System.Collections.Generic.IEnumerable<IPublishedContent>

View Source

Member(Guid)

Declaration

public IPublishedContent Member(Guid id)

Parameters

Type	Name	Description
System.Guid	id

Returns

Type	Description
IPublishedContent

View Source

Member(Int32)

Declaration

public IPublishedContent Member(int id)

Parameters

Type	Name	Description
System.Int32	id

Returns

Type	Description
IPublishedContent

View Source

Member(Object)

Declaration

public IPublishedContent Member(object id)

Parameters

Type	Name	Description
System.Object	id

Returns

Type	Description
IPublishedContent

View Source

Member(String)

Declaration

public IPublishedContent Member(string id)

Parameters

Type	Name	Description
System.String	id

Returns

Type	Description
IPublishedContent

View Source

Member(Udi)

Declaration

public IPublishedContent Member(Udi id)

Parameters

Type	Name	Description
Udi	id

Returns

Type	Description
IPublishedContent

View Source

MemberHasAccess(String)

Check if the current user has access to a document

Declaration

public bool MemberHasAccess(string path)

Parameters

Type	Name	Description
System.String	path	The full path of the document object to check

Returns

Type	Description
System.Boolean	True if the current user has access or if the current document isn't protected

View Source

MemberIsLoggedOn()

Whether or not the current member is logged in (based on the membership provider)

Declaration

public bool MemberIsLoggedOn()

Returns

Type	Description
System.Boolean	True is the current user is logged in

View Source

Members(IEnumerable<Guid>)

Declaration

public IEnumerable<IPublishedContent> Members(IEnumerable<Guid> ids)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<System.Guid>	ids

Returns

Type	Description
System.Collections.Generic.IEnumerable<IPublishedContent>

View Source

Members(IEnumerable<Int32>)

Declaration

public IEnumerable<IPublishedContent> Members(IEnumerable<int> ids)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<System.Int32>	ids

Returns

Type	Description
System.Collections.Generic.IEnumerable<IPublishedContent>

View Source

Members(IEnumerable<Object>)

Declaration

public IEnumerable<IPublishedContent> Members(IEnumerable<object> ids)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<System.Object>	ids

Returns

Type	Description
System.Collections.Generic.IEnumerable<IPublishedContent>

View Source

Members(IEnumerable<String>)

Declaration

public IEnumerable<IPublishedContent> Members(IEnumerable<string> ids)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<System.String>	ids

Returns

Type	Description
System.Collections.Generic.IEnumerable<IPublishedContent>

View Source

Members(IEnumerable<Udi>)

Declaration

public IEnumerable<IPublishedContent> Members(IEnumerable<Udi> ids)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<Udi>	ids

Returns

Type	Description
System.Collections.Generic.IEnumerable<IPublishedContent>

View Source

Members(Guid[])

Declaration

public IEnumerable<IPublishedContent> Members(params Guid[] ids)

Parameters

Type	Name	Description
System.Guid[]	ids

Returns

Type	Description
System.Collections.Generic.IEnumerable<IPublishedContent>

View Source

Members(Int32[])

Declaration

public IEnumerable<IPublishedContent> Members(params int[] ids)

Parameters

Type	Name	Description
System.Int32[]	ids

Returns

Type	Description
System.Collections.Generic.IEnumerable<IPublishedContent>

View Source

Members(Object[])

Declaration

public IEnumerable<IPublishedContent> Members(params object[] ids)

Parameters

Type	Name	Description
System.Object[]	ids

Returns

Type	Description
System.Collections.Generic.IEnumerable<IPublishedContent>

View Source

Members(String[])

Declaration

public IEnumerable<IPublishedContent> Members(params string[] ids)

Parameters

Type	Name	Description
System.String[]	ids

Returns

Type	Description
System.Collections.Generic.IEnumerable<IPublishedContent>

View Source

Members(Udi[])

Declaration

public IEnumerable<IPublishedContent> Members(params Udi[] ids)

Parameters

Type	Name	Description
Udi[]	ids

Returns

Type	Description
System.Collections.Generic.IEnumerable<IPublishedContent>

View Source

PublishedContent(Udi)

Declaration

public IPublishedContent PublishedContent(Udi udi)

Parameters

Type	Name	Description
Udi	udi

Returns

Type	Description
IPublishedContent

View Source

RenderMacro(String)

Renders the macro with the specified alias.

Declaration

public IHtmlString RenderMacro(string alias)

Parameters

Type	Name	Description
System.String	alias	The alias.

Returns

Type	Description
System.Web.IHtmlString

View Source

RenderMacro(String, IDictionary<String, Object>)

Renders the macro with the specified alias, passing in the specified parameters.

Declaration

public IHtmlString RenderMacro(string alias, IDictionary<string, object> parameters)

Parameters

Type	Name	Description
System.String	alias	The alias.
System.Collections.Generic.IDictionary<System.String, System.Object>	parameters	The parameters.

Returns

Type	Description
System.Web.IHtmlString

View Source

RenderMacro(String, Object)

Renders the macro with the specified alias, passing in the specified parameters.

Declaration

public IHtmlString RenderMacro(string alias, object parameters)

Parameters

Type	Name	Description
System.String	alias	The alias.
System.Object	parameters	The parameters.

Returns

Type	Description
System.Web.IHtmlString

View Source

RenderTemplate(Int32, Nullable<Int32>)

Renders the template for the specified pageId and an optional altTemplateId

Declaration

public IHtmlString RenderTemplate(int contentId, int? altTemplateId = null)

Parameters

Type	Name	Description
System.Int32	contentId
System.Nullable<System.Int32>	altTemplateId	If not specified, will use the template assigned to the node

Returns

Type	Description
System.Web.IHtmlString