DataTemplate vs ItemContainerTemplate

Question

What is ItemContainerTemplate used for? It is derived from DataTemplate, but I don\'t see any difference between them except the ItemContainerTemplateKey property. When shou

Answer 1

The only difference between DataTemplate and ItemContainerTemplate is the way the resource dictionary key is automatically provided (assuming it is not set explicitly). Namely, DataTemplate is decorated with [DictionaryKeyProperty("DataTemplateKey")] attribute, and the DataTemplateKey is basically defined as:

public object DataTemplateKey
{
    get { return (DataType != null) ? new DataTemplateKey(DataType) : null; 
}

See DataTemplate source for reference.

ItemContainerTemplate derives from DataTemplate, but is decorated with [DictionaryKeyProperty("ItemContainerTemplateKey")] attribute (which in practice replaces the inherited one), and ItemContainerTemplateKey property is defined as follows:

public object ItemContainerTemplateKey
{
    get { return (DataType != null) ? new ItemContainerTemplateKey(DataType) : null; }
}

See ItemContainerTemplate source for reference.

The difference seems small - DataTemplate returns an instance of DataTemplateKey and ItemContainerTemplate returns an instance of ItemContainerTemplateKey (both derive from TemplateKey). So basically these two are equivalent¹:

and so are these:

The main practical difference between these two is that DataTemplate with default key is treated as an implicit template², whereas ItemContainerTemplate is not. In fact, you need to manually reference it, e.g.:

I'm not sure about the intentions behind creating ItemContainerTemplate class. I guess it gives you a clearer overview of the code, where you know that such a template is specifically intended to be used in an ItemsControl (or a derived control). Also, I guess it would prove to be pretty simple to write a strongly reusable DataTemplateSelector that would take advantage of this class.

---

¹ They're not equivalent in the sense that created objects are of different types, but functionally they're equivalent.

² Implicit templates are applied to all objects of corresponding type within the scope, unless a template is set explicitly.