ContentPresenter.ContentSource vs Content

wpf xaml controltemplate contentpresenter
michael picture michael · Apr 8, 2011 · Viewed 8.3k times · Source

Basically, I don't understand what the real difference here is:

The Microsoft code for TabItem uses:

<ContentPresenter ContentSource="Header" ... />

So, when would one use the Content property instead of (or in addition to) ContentSource?

Answer

H.B. picture H.B. · Apr 8, 2011

This property should only be used when the ContentPresenter is in a template. When a template contains a ContentPresenter with ContentSource set to "Abc", the Content, ContentTemplate, and ContentTemplateSelector properties of the ContentPresenter are automatically aliased to Abc, AbcTemplate, and AbcTemplateSelector, respectively. Beginning with the .NET Framework version 3.5 Service Pack 1, setting ContentSource to "Abc" also causes the ContentStringFormat property to be aliased to AbcStringFormat.

The two most useful values for this property are "Content" and "Header".

(MSDN)

ContentSource apparently sets more properties at once for convenience.

Practically, The declaration:

<ContentPresenter ContentSource="Header" />

Performs the following initialization.

<ContentPresenter Content="{TemplateBinding Header}"
                  ContentTemplate="{TemplateBinding HeaderTemplate}"
                  ContentTemplateSelector="{TemplateBinding HeaderTemplateSelector}"
                  ContentStringFormat="{TemplateBinding HeaderStringFormat}" />

It does this for each property separately only if the dependency property exists on the templated control.

Related questions

ResourceDictionary in a separate assembly

I have resource dictionary files (MenuTemplate.xaml, ButtonTemplate.xaml, etc) that I want to use in multiple separate applications. I could add them to the applications' assemblies, but it's better if I compile these resources in one single assembly and …

Read More
How can I use an ElementName binding within a ControlTemplate?

I have multiple TextBlocks which reference different elements in my application. My code works fine when used directly in the page. However, I want to create a ControlTemplate and a ContentControl to reduce the duplication of code. How can I …

Read More
Template Binding in Control template

I have the following control template. I wish to set the source property for the image control in the control template using Template Binding. But since this is a control template for button control and the button control doesn't have …

Read More