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 ()
protected DataTemplate ChooseTemplate ()
protected function ChooseTemplate () : DataTemplate
You cannot use methods in XAML.

Return Value

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 a null reference (Nothing in Visual Basic), 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.

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0

Community Additions

ADD
Show: