大网数据广告活动
.NET 与 C# 开发

XAML 的集合类型

· 52CE 我爱测

本主题介绍如何定义用于支持集合的类型的属性, 以及如何支持 XAML 语法, 以便将收集项作为父对象元素或属性元素的子元素进行实例化。

本主题介绍如何定义用于支持集合的类型的属性, 以及如何支持 XAML 语法, 以便将收集项作为父对象元素或属性元素的子元素进行实例化。

XAML 集合概念

从概念上讲, XAML 中有多个子项在 XAML 对象元素或 XAML 属性元素范围内的任何关系必须作为集合实现。 该集合必须与作为该关系中的父级的 XAML 类型的特定 XAML 属性相关联。 属性必须是集合, 因为 XAML 处理器需要将标记中的每个项分配为支持集合属性的新添加项。

在 XAML 语言级别, 未完全定义集合支持的确切要求。 集合可以是列表或字典 (但不是两者) 的概念是在 XAML 语言级别定义的, 但哪些后备类型表示列表或字典不是由 XAML 语言定义的。

在 .NET Framework XAML 服务中, XAML 集合支持的概念在 .NET Framework 支持类型方面更清晰地定义。 具体而言, 对集合的 XAML 支持基于多个 .NET Framework 概念和 Api, 这些概念和 Api 一般 .NET Framework 编程中用于列表和字典。

  1. xref:System.Collections.IList接口指示列表集合。

  2. xref:System.Collections.IDictionary接口指示字典集合。

  3. xref:System.Array表示一个数组, 数组支持xref:System.Collections.IList方法。

在上述每个集合概念中, .NET Framework xaml 服务 xaml 处理器都需要对集合Add属性的类型的特定实例调用方法。 或者, 在序列化方案中, XAML 处理器会根据 "Items" 的每个集合的特定概念, 为列表、字典或数组中找到的每个项生成离散的 XAML 类型实例。 这些是: xref:System.Collections.IList.Item*;xref:System.Array.System%23Collections%23IList%23Item* ;的xref:System.Array显式。 xref:System.Collections.IDictionary.Item*

泛型集合

泛型集合可用于常规 .NET Framework 编程, 还可用于 XAML 集合属性。 但 .NET Framework XAML 服务 xaml xref:System.Collections.Generic.IList`1处理器xref:System.Collections.Generic.IDictionary`2不会将泛型接口和视为等效于非泛型xref:System.Collections.IList或xref:System.Collections.IDictionary。 对于泛型集合属性类型, 建议的方法是从类xref:System.Collections.Generic.List`1或xref:System.Collections.Generic.Dictionary`2派生, 而不是实现接口。 这些类实现非泛型接口, 因此在基实现中包含 XAML 集合的预期支持。

只读集合和初始化逻辑

在 .NET Framework 编程中, 它是一种常见的设计模式, 用于将集合的值保存为只读集合。 此模式允许拥有集合属性的实例更好地控制对集合执行的操作。 具体而言, 该模式通过设置属性来防止意外替换现有的全部集合。 在此模式中, 调用方对集合的任何访问都应该通过调用集合类型和/或相关集合接口 (如) xref:System.Collections.IList所支持的方法或属性来进行。

使用此模式意味着公开只读集合属性的任何类必须首先初始化该属性以保存空集合。 通常, 在类的构造行为中执行初始化。 若要对 XAML 有用, 这一点很重要, 无参数的构造函数始终引用此类逻辑, 因为 XAML 通常在处理属性 (集合属性或其他) 之前调用无参数的构造函数。

XAML 类型系统支持和集合

除了分析 XAML 和填充或序列化集合属性的基本机制外, XAML 类型系统在 .NET Framework XAML 服务中实现的功能包括多个与 XAML 中的集合相关的设计功能。

  1. xref:System.Xaml.XamlType.IsCollection*如果 XAML 类型受提供 XAML 集合支持的类型的支持, 则返回 true。

  2. xref:System.Xaml.XamlType.IsDictionary*和xref:System.Xaml.XamlType.IsArray*可以进一步确定 XAML 类型支持的收集模式。 对于基于 .NET Framework xaml 服务和 XAML 类型系统, 但不基于现有xref:System.Xaml.XamlWriter实现的自定义 XAML 处理器, 知道使用哪种收集模式可能是必需的, 以便知道要调用哪个方法。集合处理。

  3. 前面的每个属性值都可能会受到 XAML 类型xref:System.Xaml.XamlType.LookupCollectionKind*上的重写影响。

历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 03/30/2017
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。