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.

Run this sample

<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.