为 XAML 中的非参数构造函数对象元素声明或工厂方法对象声明包构造参数。
XAML 元素使用情况 (Nonparameterless 构造函数)
<object ...>
<x:Arguments>
oneOrMoreObjectElements
</x:Arguments>
</object>
XAML 元素使用情况 (工厂方法)
<object x:FactoryMethod="methodName"...>
<x:Arguments>
oneOrMoreObjectElements
</x:Arguments>
</object>
XAML 值
oneOrMoreObjectElements |
一个或多个对象元素, 用于指定要传递给支持的非参数构造函数或工厂方法的参数。 典型用法是使用对象元素中的初始化文本来指定实际参数值。 请参阅示例部分。 元素的顺序非常重要。 按顺序排列的 XAML 类型必须与后备构造函数或工厂方法重载的类型和类型顺序相匹配。 |
methodName |
应处理任何x:Arguments参数的工厂方法的名称。 |
依赖项
x:FactoryMethod可以修改x:Arguments应用的作用域和行为。
如果未x:FactoryMethod指定, x:Arguments则应用于后备构造函数的备用 (非默认) 签名。
如果x:FactoryMethod指定, x:Arguments则应用于命名方法的重载。
备注
XAML 2006 可以通过初始化文本支持非默认初始化。 但是, 初始化文本构造技术的实际应用程序是有限的。 初始化文本被视为单个文本字符串;因此, 它仅添加单个参数初始化的功能, 除非为构造行为定义了一个类型转换器, 此构造行为可分析自定义信息项和字符串中的自定义分隔符。 此外, 文本字符串到对象逻辑可能是给定的 XAML 分析器用于处理除 true 字符串以外的基元的本机默认类型转换器。
x:Arguments XAML 用法不是典型意义上的属性元素用法, 因为指令标记不引用包含对象元素的类型。 它更类似于其他指令, 例如x:Code元素 demarks 的范围, 其中的标记应被解释为除子内容的默认值以外的其他指令。 在这种情况下, 每个对象元素的 XAML 类型会传达有关参数类型的信息, xaml 分析器使用这些信息来确定x:Arguments使用情况正在尝试引用的特定构造函数工厂方法签名。
x:Arguments对于正在构造的对象元素, 必须在该对象元素的任何其他属性元素、内容、内部文本或初始化字符串之前。 中x:Arguments的对象元素可以包括属性和初始化字符串, 这是该 XAML 类型及其后备构造函数或工厂方法所允许的。 对于对象或参数, 可以通过引用已建立的前缀映射来指定默认 XAML 命名空间之外的自定义 XAML 类型或 XAML 类型。
XAML 处理器使用以下准则来确定应如何使用中x:Arguments指定的参数来构造对象。 如果x:FactoryMethod指定了, 则会将信息与指定x:FactoryMethod的 ( x:FactoryMethod请注意, 的值为方法名称, 并且命名方法可以具有重载。 如果x:FactoryMethod未指定, 则会将信息与对象的所有公共构造函数重载集进行比较。 然后, XAML 处理逻辑会比较参数的数目, 并选择具有匹配 arity 的重载。 如果有多个匹配项, 则 XAML 处理器应根据提供的对象元素的 XAML 类型来比较参数的类型。 如果仍有多个匹配项, 则 XAML 处理器行为是不确定的。 如果指定x:FactoryMethod了, 但无法解析方法, 则 XAML 处理器应引发异常。
从技术上讲<x:Arguments>string</x:Arguments> , 可以使用 XAML 属性。 但是, 这不会提供除通过初始化文本和类型转换器以外的任何功能, 并且使用此语法不是 XAML 2009 工厂方法功能的设计意图。
示例
下面的示例演示一个无参数的构造函数签名, 然后是x:Arguments用于访问该签名的的 XAML 用法。
public class Food {
private string _name;
private Int32 _calories;
public Food(string name, Int32 calories) {
_name=name;
_calories=calories;
}
}
<my:Food>
<x:Arguments>
<x:String>Apple</x:String>
<x:Int32>150</x:Int32>
</x:Arguments>
</my:Food>
下面的示例演示了一个目标工厂方法签名, 然后是x:Arguments用于访问该签名的的 XAML 用法。
public Food TryLookupFood(string name)
{
switch (name) {
case "Apple": return new Food("Apple",150);
case "Chocolate": return new Food("Chocolate",200);
case "Cheese": return new Food("Cheese", 450);
default: {return new Food(name,0);
}
}
<my:Food x:FactoryMethod="TryLookupFood">
<x:Arguments>
<x:String>Apple</x:String>
</x:Arguments>
</my:Food>
请参阅
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
