ContentPresenter.ChooseTemplate Method

Returns the template to use. This may depend on the content or other properties.

Namespace:  System.Windows.Controls
Assembly:  PresentationFramework (in PresentationFramework.dll)

protected virtual DataTemplate ChooseTemplate()

Return Value

Type: System.Windows.DataTemplate
The DataTemplate to use.

The base class implements the following rules:

  1. If ContentTemplate is set, use it.

  2. If ContentTemplateSelector is set, call its SelectTemplate method. If the result is not null, use it.

  3. Look for a DataTemplate whose DataType matches the content among the resources known to the ContentPresenter (including application, theme, and system resources). If one is found, use it.

  4. If the type of Content is "common", use a standard template. The common types are String, XmlNode, and UIElement.

  5. Otherwise, use a default template that essentially converts Content to a string and displays it in a TextBlock.

Derived classes can override these rules and implement their own.

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft