将 XAML 标记编译配置为在标记和代码隐藏之间加入分部类。 代码分部类在单独的代码文件中以公共语言规范 (CLS) 语言定义, 而标记分部类通常在 XAML 编译过程中由代码生成创建。
XAML 属性用法
<object x:Class="namespace.classname"...>
...
</object>
XAML 值
namespace |
可选。 指定一个 CLR 命名空间, 该命名空间包含由classname标识的分部类。 如果namespace指定了, 则句点 (.) 分隔namespace和classname。 请参阅“备注”。 |
classname |
必需。 指定用于连接加载的 XAML 的分部类的 CLR 名称和该 XAML 的代码隐藏。 |
依赖项
x:Class只能在 XAML 生产的根元素上指定。 x:Class对于在 XAML 生产中具有父对象的任何对象无效。 有关详细信息, 请参阅 [] 4.3.1.6 部分。
备注
namespace值可能包含用于将相关命名空间组织到名称层次结构中的其他点, 这是 .NET Framework 编程的一种常用技术。 只有x:Class值字符串中的最后一个点被解释为单独namespace的, classname.且使用x:Class的类不能为嵌套类。 不允许使用嵌套类, 因为如果允许嵌套类, x:Class则确定字符串点的含义不明确。
在使用x:Class的现有编程模型中x:Class , 是可选的, 因为有一个 XAML 页没有代码隐藏。 但是, 该功能与使用 XAML 的框架实现的生成操作交互。 x:Class功能还受 XAML 指定内容的各种分类在应用程序模型中以及对应的生成操作中的作用。 如果 XAML 声明事件处理特性值或实例化自定义元素 (其中定义类在代码隐藏类中), 则必须向适当的类x:Class提供指令引用 (或x:Subclass)。代码隐藏。
x:Class指令的值必须是一个字符串, 该字符串指定类的完全限定名称, 但不包含任何程序集信息 (等效xref:System.Type.FullName*?displayProperty=nameWithType于)。 对于简单应用程序, 如果代码隐藏也是以这种方式构造的, 则可以省略 CLR 命名空间信息 (代码定义从类级别开始)。
页面或应用程序定义的代码隐藏文件必须位于代码文件中, 该代码文件包含在生成已编译的应用程序并涉及标记编译的项目中。 必须遵循 CLR 类的名称规则。 有关详细信息, 请参阅框架设计准则。 默认情况下, 代码隐藏类必须是public; 但是, 您可以使用x:ClassModifier 指令在不同的访问级别定义它。
此x:Class属性的解释仅适用于基于 CLR 的 xaml 实现, 尤其是 .NET Framework xaml 服务。 其他不基于 CLR 并且不使用 .NET Framework XAML 服务的 XAML 实现可能会使用不同的解析公式来连接 XAML 标记和支持运行时代码。 有关的更多一般解释的x:Class详细信息, 请参阅 ["MS-XAML]"。
在体系结构的某个级别上, 的含义x:Class在 .NET Framework XAML 服务中未定义。 这是因为 .NET Framework XAML 服务不指定用于连接 XAML 标记和支持代码的编程模型。 x:Class指令的其他用法可能由使用编程模型或应用程序模型的特定框架实现, 以定义如何连接 XAML 标记和基于 CLR 的代码隐藏。 每个框架都可以有自己的生成操作, 这些操作可实现某些必须包括在生成环境中的行为或特定组件。 在框架中, 生成操作也可能根据用于代码隐藏的特定 CLR 语言而有所不同。
WPF 编程模型中的 x:Class
在 wpf 应用程序和 wpf 应用程序模型x:Class中, 可以将作为 xaml 文件的根并且正在编译 (其中, XAML 包含在包含Page生成操作的 WPF 应用程序项目中) 的任何元素的属性声明为属性, 或将其声明为 <c4 > xref:System.Windows.Application 根在已编译的 WPF 应用程序的应用程序定义中。 在x:Class页根或应用程序根以外的元素或未编译的 WPF xaml 文件上声明会导致 .NET Framework 3.0 和 .NET Framework 3.5 WPF xaml 编译器下出现编译时错误。 有关 wpf 中的其他处理x:Class方面的信息, 请参阅wpf 中的代码隐藏和 XAML。
适用于 Windows Workflow Foundation 的 x:Class
对于 "Windows Workflow Foundation x:Class ", 请对完全在 XAML 中组成的自定义活动的类进行命名, 或使用代码隐藏为活动设计器命名 XAML 页的分部类。
Silverlight 使用说明
x:Class对于 Silverlight, 单独记录。 有关详细信息, 请参阅 XAML 命名空间 (x:)语言功能 (Silverlight)。
请参阅
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
