ContentPropertyAttribute 类

定义

public ref class ContentPropertyAttribute sealed : Attribute

[Windows.Foundation.Metadata.AttributeUsage(System.AttributeTargets.RuntimeClass)]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
public sealed class ContentPropertyAttribute : Attribute

Public NotInheritable Class ContentPropertyAttribute
Inherits Attribute

继承

Attribute

ContentPropertyAttribute

属性

AttributeUsageAttribute ContractVersionAttribute

注解

此属性用于标识由 XAML 分析程序和其他 XAML 框架代码解释时，应将特性化类型的特定属性视为 XAML 内容属性。 XAML 内容属性的用途是，它提供一个 XAML 语法速记，可以省略该属性的属性元素标记。 删除属性元素有助于在 XAML 标记中实现更自然的父子形式。 有关 XAML 内容属性的详细信息，请参阅 XAML 语法指南的“XAML 内容属性”部分。

应用了 ContentPropertyAttribute 的默认Windows 运行时 XAML 词汇中的类的一个示例是 Panel。 Panel 上的属性 Children 被标识为由 ContentPropertyAttribute 及其 Name 值定义的 XAML 内容属性。 内容属性信息由所有派生类型的 Panel 继承，例如 Grid 、 Canvas 和 StackPanel。

此代码近似于 Panel 如何在 C# 中应用 ContentPropertyAttribute， (在本机代码中应用真实定义，此代码仅用于演示) ：

[ContentProperty(Name = "Children")]
    public class Panel : FrameworkElement
    { ...}

使用 Panel 及其派生类 StackPanel 作为 XAML 内容属性概念的插图，你可能具有以下 XAML：

<StackPanel>
  <StackPanel.Children>
    <TextBlock>Testing content attribute</TextBlock>
  </StackPanel.Children>
</StackPanel>

上述内容等效于此更具可读性 XAML：

<StackPanel>
  <TextBlock>Testing content attribute</TextBlock>
</StackPanel>

当由 XAML 分析程序分析时，分析程序通过面板上应用的 ContentPropertyAttribute 知道，在 StackPanel 标记的正文中找到的任何内容都应用于在创建的 StackPanel 实例上设置 Children 的值。

在 TextBlock 类上可以看到另一个运行中的 ContentPropertyAttribute 的突出示例。 TextBlock 使用 Inlines 作为其内容属性，默认内联类 Run 使用 Text 作为其内容属性。 内容属性的组合可实现简单的内联语法，例如 <TextBlock>Hello</TextBlock>，即使此 XAML 创建的对象图更为复杂，并且还能够根据需要支持多个显式内联元素。

构造函数

字段

适用于

另请参阅

• Attribute
• XAML 语法指南
• XAML概述