ContentControl.Content 屬性

定義

取得或設定 ContentControl 的內容。Gets or sets the content of a ContentControl.

public:
 property System::Object ^ Content { System::Object ^ get(); void set(System::Object ^ value); };
[System.ComponentModel.Bindable(true)]
public object Content { get; set; }
[<System.ComponentModel.Bindable(true)>]
member this.Content : obj with get, set
Public Property Content As Object

屬性值

Object

包含控制項之內容的物件。An object that contains the control's content. 預設值是 nullThe default value is null.

屬性

範例

下列範例示範如何建立四個 Button 控制項,並 Content 將其設定為下列其中一項:The following example demonstrates how to create four Button controls with Content set to one of the following:

注意

雖然 Extensible Application Markup Language (XAML)Extensible Application Markup Language (XAML) 範例的版本可能會在 <Button.Content> 每個按鈕的內容周圍使用標籤,但這並不是必要的。Although the Extensible Application Markup Language (XAML)Extensible Application Markup Language (XAML) version of the example could use the <Button.Content> tags around the content of each button, it is not necessary. 如需詳細資訊,請參閱 XAML 總覽 (WPF) For more information, see XAML Overview (WPF).

<!--Create a Button with a string as its content.-->
<Button>This is string content of a Button</Button>

<!--Create a Button with a DateTime object as its content.-->
<Button xmlns:sys="clr-namespace:System;assembly=mscorlib">
  <sys:DateTime>2004/3/4 13:6:55</sys:DateTime>
</Button>

<!--Create a Button with a single UIElement as its content.-->
<Button>
  <Rectangle Height="40" Width="40" Fill="Blue"/>
</Button>

<!--Create a Button with a panel that contains multiple objects 
as its content.-->
<Button>
  <StackPanel>
    <Ellipse Height="40" Width="40" Fill="Blue"/>
    <TextBlock TextAlignment="Center">Button</TextBlock>
  </StackPanel>
</Button>
// Create a Button with a string as its content.
Button stringContent = new Button();
stringContent.Content = "This is string content of a Button";

// Create a Button with a DateTime object as its content.
Button objectContent = new Button();
DateTime dateTime1 = new DateTime(2004, 3, 4, 13, 6, 55);

objectContent.Content = dateTime1;

// Create a Button with a single UIElement as its content.
Button uiElementContent = new Button();

Rectangle rect1 = new Rectangle();
rect1.Width = 40;
rect1.Height = 40;
rect1.Fill = Brushes.Blue;
uiElementContent.Content = rect1;

// Create a Button with a panel that contains multiple objects 
// as its content.
Button panelContent = new Button();
StackPanel stackPanel1 = new StackPanel();
Ellipse ellipse1 = new Ellipse();
TextBlock textBlock1 = new TextBlock();

ellipse1.Width = 40;
ellipse1.Height = 40;
ellipse1.Fill = Brushes.Blue;

textBlock1.TextAlignment = TextAlignment.Center;
textBlock1.Text = "Button";

stackPanel1.Children.Add(ellipse1);
stackPanel1.Children.Add(textBlock1);

panelContent.Content = stackPanel1;
' Add a string to a button.
Dim stringContent As New Button()
stringContent.Content = "This is string content of a Button"

' Add a DateTime object to a button.
Dim objectContent As New Button()
Dim dateTime1 As New DateTime(2004, 3, 4, 13, 6, 55)

objectContent.Content = dateTime1

' Add a single UIElement to a button.
Dim uiElementContent As New Button()

Dim rect1 As New Rectangle()
rect1.Width = 40
rect1.Height = 40
rect1.Fill = Brushes.Blue
uiElementContent.Content = rect1

' Add a panel that contains multpile objects to a button.
Dim panelContent As New Button()
Dim stackPanel1 As New StackPanel()
Dim ellipse1 As New Ellipse()
Dim textBlock1 As New TextBlock()

ellipse1.Width = 40
ellipse1.Height = 40
ellipse1.Fill = Brushes.Blue

textBlock1.TextAlignment = TextAlignment.Center
textBlock1.Text = "Button"

stackPanel1.Children.Add(ellipse1)
stackPanel1.Children.Add(textBlock1)

panelContent.Content = stackPanel1

下圖顯示上一個範例中所建立的四個按鈕。The following illustration shows the four buttons created in the previous example.

四個按鈕Four buttons

備註

因為 Content 屬性的類型是 Object ,所以不會限制您可以放入哪些內容 ContentControlBecause the Content property is of type Object, there are no restrictions on what you can put in a ContentControl. Content會顯示 ContentPresenter ,它位於的中 ControlTemplate ContentControlThe Content is displayed by a ContentPresenter, which is in the ControlTemplate of the ContentControl. 中的每個 ContentControl 類型 WPFWPF 都有 ContentPresenter 預設值 ControlTemplateEvery ContentControl type in WPFWPF has a ContentPresenter in its default ControlTemplate. 如需如何顯示的詳細 ContentPresenter 資訊 Content ,請參閱 ContentPresenterFor more information about how the ContentPresenter displays Content, see ContentPresenter.

相依性屬性資訊Dependency Property Information

識別碼欄位Identifier field ContentProperty
中繼資料屬性設定為 trueMetadata properties set to true NoneNone

XAML Attribute UsageXAML Attribute Usage

<object Content="content"/>  

XAML 屬性項目用法XAML Property Element Usage

<object> content</object>  

XAML 值XAML Values

Content
文字或單一物件。Text or a single object.

適用於