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

x:Arguments 指令

· 52CE 我爱测

为 XAML 中的非参数构造函数对象元素声明或工厂方法对象声明包构造参数。

为 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,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

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

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

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