有关在 XAML 中通过标记扩展的对象的数组,提供了常规支持。 这对应于x:ArrayExtension[MS-XAML] 中的 XAML 类型。
XAML 对象元素用法
<x:Array Type="typeName">
arrayContents
</x:Array>
XAML 值
typeName |
类型的名称,你x:Array将包含。 typeName 可能会 (并且通常为) 作为前缀的 XAML 命名空间包含 XAML 的类型定义。 |
arrayContents |
分配给该内部函数的项内容ArrayExtension.Items属性。 通常情况下,这些项被指定为中包含的一个或多个对象元素x:Array开始和结束标记。 此处应为可分配给中指定的 XAML 类型的指定对象typeName。 |
备注
Type 为所有的必需的属性x:Array对象元素。 一个Type参数值不需要使用x:Type标记扩展; 短类型的名称是 XAML 类型,这可以指定为字符串。
在.NET Framework XAML 服务实现中,输入的 XAML 类型和 CLR 的输出之间的关系xref:System.Type创建数组的会影响服务上下文的标记扩展。 输出xref:System.Type是xref:System.Xaml.XamlType.UnderlyingType*后查找所需的输入的 XAML 类型xref:System.Xaml.XamlType基于 XAML 架构上下文和xref:System.Windows.Markup.IXamlTypeResolver上下文提供的服务。
处理时,将数组内容分配给ArrayExtension.Items内部属性。 在中xref:System.Windows.Markup.ArrayExtension实现中,这由xref:System.Windows.Markup.ArrayExtension.Items*?displayProperty=nameWithType。
在.NET Framework XAML 服务实现中,对此标记扩展的处理由定义xref:System.Windows.Markup.ArrayExtension类。 xref:System.Windows.Markup.ArrayExtension 未密封,并且无法用作自定义的数组类型的标记扩展插件实现的基础。
x:Array 是的详细信息适用于常规 XAML 语言可扩展性。 但x:Array还可用于指定 XAML 的 XAML 支持的集合作为其结构化的属性内容某些属性的值。 例如,可以指定的内容xref:System.Collections.IEnumerable具有属性x:Array使用情况。
x:Array 是标记扩展。 当要求转义特性值应为非文本值或非处理程序名称时,通常会实现标记扩展,相对于只在某些类型或属性上放置类型转换器而言,此需求更具有全局性。 x:Array 部分是该规则的例外,因为而不是提供替代属性值处理x:Array另类处理其内部文本内容。 此行为使现有的内容模型以进行分组到一个数组和更高版本在代码隐藏中引用的访问已命名的数组; 可能不支持的类型您可以调用xref:System.Array方法来获取个人数组项。
在 XAML 中的所有标记扩展都使用大括号 ({,} )在其特性语法,该命令是依据 XAML 处理器认定标记扩展必须处理的属性值的约定。 有关通常的标记扩展的详细信息,请参阅Type Converters and Markup Extensions for XAML。
在 XAML 2009 年,x:Array定义为一种语言基元而不是标记扩展。 有关详细信息,请参阅常见 XAML 语言基元的内置类型。
WPF 用法说明
通常情况下,填充的对象元素x:Array不是元素中存在的WPFXAML 命名空间,并且需要对非默认 XAML 命名空间的前缀映射。
例如,以下是两个字符串的简单数组与sys前缀 (以及x) 数组的级别定义。
<x:Array Type="sys:String"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:sys="clr-namespace:System;assembly=mscorlib">
<sys:String>Hello</sys:String>
<sys:String>World</sys:String>
</x:Array>
对于用作数组元素的自定义类型,类还必须支持在 XAML 中作为对象元素实例化的要求。 有关详细信息,请参阅XAML 及 WPF 的自定义类。
请参阅
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
