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

x:TypeArguments 指令

· 52CE 我爱测

如果泛型约束自身使用的泛型类型,括号 () 可以包含嵌套的约束类型参数。

约束类型参数传递给泛型类型的构造函数的泛型。

XAML 属性用法

<object x:TypeArguments="typeString" .../>  

XAML 值

object 由 CLR 泛型类型提供支持的 XAML 类型的对象元素声明。 如果object不是默认 XAML 命名空间中的 XAML 类型是指object需要一个指示 XAML 命名空间前缀其中object存在。
typeString 一个字符串,声明一个或多个 XAML 类型名称以字符串形式提供的类型参数的 CLR 泛型类型。 有关其他语法说明,请参阅备注。

备注

在大多数情况下,为信息项中使用的 XAML 类型typeString字符串作为前缀。 典型类型的 CLR 的泛型约束 (例如,xref:System.Int32和xref:System.String) 来自 CLR 基类库。 这些库不映射到典型的特定于框架的默认 XAML 命名空间,因此,对于 XAML 使用情况需要前缀映射。

可以通过使用逗号分隔符指定多个 XAML 类型名称。

如果泛型约束自身使用的泛型类型,括号 () 可以包含嵌套的约束类型参数。

请注意,此定义的x:TypeArguments是特定于.NET Framework XAML 服务和使用 CLR 支持。 可以在中找到的语言级别定义 [MS XAML]部分 5.3.11。

用法示例

对于这些示例,假定声明以下 XAML 命名空间定义:

xmlns:sys="clr-namespace:System;assembly=mscorlib"  
xmlns:scg="clr-namespace:System.Collections.Generic;assembly=mscorlib"  

列表<字符串 >

<scg:List x:TypeArguments="sys:String" ...> 实例化新xref:System.Collections.Generic.List`1与xref:System.String类型实参。

字典<字符串、 字符串 >

<scg:Dictionary x:TypeArguments="sys:String,sys:String" ...> 实例化新xref:System.Collections.Generic.Dictionary`2具有两个xref:System.String类型参数。

队列 < KeyValuePair<String,String >>

<scg:Queue x:TypeArguments="scg:KeyValuePair(sys:String,sys:String)" ...> 实例化新xref:System.Collections.Generic.Queue`1具有的约束xref:System.Collections.Generic.KeyValuePair`2内部约束类型参数与xref:System.String和xref:System.String。

XAML 2006 和 WPF 泛型 XAML 用法

有关 XAML 2006 使用情况和 XAML 的 WPF 应用程序使用,存在以下限制x:TypeArguments和从 XAML 中常规的泛型类型用法:

  • XAML 文件的根元素可以支持引用泛型类型的泛型 XAML 用法。

  • 根元素必须映射到具有至少一个类型参数的泛型类型。 例如, xref:System.Windows.Navigation.PageFunction`1。 页函数是 XAML 在 WPF 中的泛型用法支持的主要方案。

  • 泛型的根元素 XAML 对象元素还必须声明分部类使用x:Class。 即使定义 WPF 生成操作,这是如此。

  • x:TypeArguments 不能引用嵌套的泛型约束。

XAML 2009 或不带任何 WPF 3.0 或 3.5 WPF XAML 2006 依赖关系

在.NET Framework XAML 服务 XAML 2006 或 XAML 2009,放宽了对泛型的 XAML 用法的 WPF 相关限制。 您可以实例化泛型对象元素,在后备类型系统和对象模型可以支持的 XAML 标记中的任意位置。

如果使用 XAML 2009 而不是将 CLR 映射基类型来获取常用语言基元的 XAML 类型转换,则可以使用常见 XAML 语言基元的内置类型中的信息项作为typeString。 例如,您可以声明以下 (前缀映射不显示,但 x 是 XAML 2009 的 XAML 语言 XAML 命名空间):

<my:BusinessObject x:TypeArguments="x:String,x:Int32"/>  

在 WPF 和面向.NET Framework 4 时,您可以使用 XAML 2009 功能一起使用x:TypeArguments但只针对松散 XAML (未标记编译的 XAML)。 WPF 的已编译标记的 XAML 以及 XAML 的 BAML 形式当前不支持 XAML 2009 关键字和功能。 如果需要为标记编译 XAML,您必须在"XAML 2006 和 WPF 泛型 XAML 用法"部分中所述的限制下进行操作。

请参阅

历史资料。此文对应 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(示例代码)

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

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