Johan Björnfot
Optimizely
Nov 30, 2012
visibility 28186
star star star star star
(4 votes)

Shared blocks – IContent

Blocks is a new building block introduced in EPiServer CMS 7. A block can be used in several ways, it can be used as a “complex” property when modeling content types. It is also possible to create stand alone instances of blocks (shared blocks) that can be reused on content areas on other content  instances. Joel have written an good post about how to work with block properties (see http://joelabrahamsson.com/entry/working-programmatically-with-local-blocks-in-episerver-7 ). In this post I am going to explain a bit about how to work programmatically with shared block instances.

IContent

In previous versions of CMS was pages (PageData) the only content type that the content repository (traditionally DataFactory) handled. In CMS7 this has changed so now content repository (IContentRepository) handles IContent instances. This means that the requirement for a .NET type to be possible to save/load from content repository is that it implements the interface EPiServer.Core.IContent.

There are some implementations of IContent built into CMS like PageData and ContentFolder (used to group shared block instances) and it is also possible to register custom IContent implementations.

If you look at BlockData though you will notice that it doesn’t implement IContent, how is then shared block instances handled? The answer is that during runtime when a shared block instance is created (e.g. through a call to IContentRepository.GetDefault<T> where T is a type inheriting from BlockData) the CMS will create a new .NET type inheriting T using a technic called mixin where the new generated subclass will implement some extra interfaces (including IContent).

That means that a shared block instance of T will implement IContent while an instance of T that is a property on a Page will not. If you attach a debugger and look at the instance returned from GetDefault<T> (where T is a type inheriting BlockData) you can see that the instance looks like:

SharedBlock

Here we can see that the shared block instance have some extra fields for each interface that is mixed in.

So when working with shared blocks towards IContentRepository you can cast instance to IContent like below:
var repository = Locate.ContentRepository();

var sharedBlock = repository.GetDefault<ButtonBlock>(ContentReference.GlobalBlockFolder);
sharedBlock.ButtonLink = new Url("http://world.episerver.com");
sharedBlock.ButtonText = "world";

//Since this is a shared block instance I can cast it to IContent
var content = sharedBlock as IContent;
content.Name = "MyButton";
var savedReference = repository.Save(content, DataAccess.SaveAction.Publish);

//I do not need to load it as ButtonBlock, here I load it as IContent
var loaded = repository.Get<IContent>(savedReference);
Debug.Assert(loaded.Name == content.Name);

Behavioral interfaces

As described above IContent is a required interface for content. In addition to IContent there are a number of behavioral interface that is optional for a content type to implement depending on if that behavior should be supported. Below is a list of the behavioral interfaces with a short description on what they contain/support:

IVersionable

Implement to supports versioning.

ILocalizable

Implement to support multi language.

ICategorizable

Implement to support categorizing.

ISecurable

Implement to support readonly access checks.

IContentSecurable

Implement to support access checks that is also possible to modify through IContentSecurityRepository.

IChangeTrackable

Implement to support change tracking.

IModifiedTrackable

Implement to support modified tracking.

IReadOnly/IReadOnly<T>

Implement  to ensure cached instances are immutable.

IResourceble

Implement to state that instance supports content folder.

IExportable

Implement to control if the instance should implicitly be added to export package when referenced (e.g. from ContentArea).

IRoutable

Implement if is should be possible to route to instance (without partial router).

Suggested patterns

The suggested pattern when working with metadata on content is to cast the instance to the corresponding interface with as operator and then act depending on if the interface is implemented or not like in example below:

private string GetRoutingSegment(IContent content)
{
   IRoutable routable = content as IRoutable;
   return routable != null ? routable.RouteSegment : null;
}
And since types are dynamically subclassed you should not use exact type match as below to check a type
if (typeof(ButtonBlock) == content.GetType())

instead you can use operators is, as or method IsAssignableFrom like:

if (content is ButtonBlock) {/*code*/ }

var buttonBlock = content as ButtonBlock;
if (buttonBlock != null)
{ /*code*/ }

if (typeof(ButtonBlock).IsAssignableFrom(content.GetType()))
{ /*code*/ }
Nov 30, 2012

Comments

valdis
valdis Jun 13, 2013 11:09 AM

Old post, but helped to find a way to retrieve Modified date for the block :) thx

Sep 6, 2013 09:19 AM

Very nice explanation. When you see this constructs in code, it is hard to believe why this magic has to happen.

error Please login to comment.
Latest blogs
Lessons From the Optimizely Web Experimentation Compromise

Introduction On 16th November 2026, Scott Helme and the team at Report URI published a detailed investigation into malicious JavaScript being serve...

Mark Stott | Nov 17, 2026

From Review to Release: Publishing My First Optimizely OCP App

Building an OCP app is only half the story. This post follows Publish Child Items from its first submission to a live App Directory release: what...

Chirag Khanna | Nov 16, 2026 |

Brilliant and Ignorant: Building an Optimizely Knowledge Base for AI Agents

Claude is a brilliant developer who has never seen Optimizely. How we gave our agents the framework experience a human needs half a year to earn:...

Allan Thraen | Nov 16, 2026 |

Budgeting for Agent Platform credits in 2027

How to budget for Optimizely Agent Platform (formerly Opal) credits in 2027: what a credit buys, how to size use cases, and what to agree with...

Matthew Dunn | Nov 15, 2026 |