ContentControl.Content Property (System.Windows.Controls)

.NET Framework Class Library for Silverlight

ContentControl..::.Content Property

Gets or sets the value of the ContentControl dependency property.

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

Syntax

Visual Basic (Declaration)

Public Property Content As Object
    Get
    Set

Visual Basic (Usage)

Dim instance As ContentControl
Dim value As Object

value = instance.Content

instance.Content = value

public Object Content { get; set; }

XAML Object Element Usage

<contentControl>
  singleObject
</contentControl>

XAML Attribute Usage

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

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.

Property Value

Type: System..::.Object
An object that contains the control's content. The default is nullNothingnullptra 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 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

XAML

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

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

Reference

ContentControl Class

ContentControl Members

System.Windows.Controls Namespace