ContentControl.Content Property
Microsoft Silverlight will reach end of support after October 2021. Learn more.
Gets or sets the value of the ContentControl dependency property.
Namespace: System.Windows.Controls
Assembly: System.Windows (in System.Windows.dll)
Syntax
'Declaration
Public Property Content As Object
public Object Content { get; set; }
<contentControl>
singleObject
</contentControl>
-or-
<contentControl>stringContent</contentControl>
<contentControl Content="stringContent"/>
XAML Values
contentControl
A ContentControl object element, or an object element for a class that derives from ContentControl.singleObject
A single object element that declares the content. Typically this is a class that can support further content as child elements, such as a Panel class.stringContent
A string that is the Content of the ContentControl. When you set the Content to a string in XAML, you must use the attribute value syntax.
Property Value
Type: System.Object
An object that contains the control's content. The default is nulla null reference (Nothing in Visual Basic).
Remarks
Dependency property identifier field: ContentProperty
The Content property of a ContentControl can be any type of object, such as a string, a UIElement, or a DateTime. When Content is set to a UIElement, the UIElement is displayed in the ContentControl. When Content is set to another type of object, a string representation of the object is displayed in the ContentControl.
Content is the XAML content property of ContentPresenter and can thus support this content element syntax, as opposed to having to specify contentControl.Content as a property element.
Content Model: This property is used to set the content of controls that inherit from ContentControl and can be any object.
Examples
The following example shows how to set different types of content for two Button controls and a CheckBox, which inherit from ContentControl.
<StackPanel Name="root" Width="200" HorizontalAlignment="Center" VerticalAlignment="Center">
<!--Create a Button with a string as its content.-->
<Button Margin="10" Content="This is string content of a Button"/>
<!--Create a Button with a single UIElement as its content.-->
<Button Margin="10">
<Rectangle Height="40" Width="40" Fill="Blue"/>
</Button>
<!--Create a Button with a panel that contains
multiple objects as its content.-->
<CheckBox Margin="10">
<StackPanel Margin="3,0,0,0" Orientation="Horizontal">
<Ellipse Height="10" Width="10" Fill="Blue"/>
<TextBlock TextAlignment="Center" Text="A string of text"></TextBlock>
</StackPanel>
</CheckBox>
</StackPanel>
Version Information
Silverlight
Supported in: 5, 4, 3
Silverlight for Windows Phone
Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0
Platforms
For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.