Umbraco ContentModelExtensions

ReadMe.md

Umbraco ContentModelExtensions Reference

Typical usage:

Umbraco Razor Views:

@inherits Umbraco.Web.Mvc.UmbracoTemplatePage
@{
    ContactPage page = Model.Content.As<ContactPage>();
}

Getting a list of content nodes from a property:

IEnumerable<Article> related = Model.Content.GetPropertyValue<IEnumerable<IPublishedContent>>("relatedArticles")
                                            .As<Article>();

ContentModelExtensions.cs

using System;
using System.Collections.Generic;
using System.Linq;
using Umbraco.Core.Models;

namespace Project.Code.Models.Content
{
    public static class ContentModelExtensions
    {
        /// <summary>
        /// Create an instance of T from the content
        /// </summary>
        /// <typeparam name="T">class to convert to</typeparam>
        /// <param name="content"></param>
        /// <returns></returns>
        public static T As<T>(this IPublishedContent content)
        {
            // optimised if the content object is already the expected type
            if (content == null || content is T)
            {
                return (T)content;
            }
            // supports returning Interface-based Partial Document Type definitions
            // i.e. ContentPage : ISEO can be returned as an ISEO instance.
            if (typeof(T).IsInterface)
            {
                return default(T);
            }

            return (T)Activator.CreateInstance(typeof(T), content);
        }

        /// <summary>
        /// Convert the list of content items to type T
        /// </summary>
        /// <typeparam name="T">class to convert to</typeparam>
        /// <param name="content"></param>
        /// <returns></returns>
        public static IEnumerable<T> As<T>(this IEnumerable<IPublishedContent> content)
        {
            if (typeof(T) == typeof(IPublishedContent))
                return (IEnumerable<T>)content;

            return (content ?? Enumerable.Empty<IPublishedContent>()).Select(t => t.As<T>());
        }
    }
}