命名空间和类型可见性 (C++/CX)

命名空间为标准 C++ 构造,用于分组具有相关功能的类型和阻止库中发生名称冲突。 Windows 运行时类型系统要求必须在命名空间范围内的命名空间中声明所有公共 Windows 运行时类型(包括您自己的代码中的那些类型)。 在全局范围内声明的或嵌套在其他类中的公共类型将导致编译时错误。

.winmd 文件必须具有和根命名空间相同的名称。 例如,名为 A.B.C.MyClass 的类只有在名为 A.winmd 或 A.B.winmd 或 A.B.C.winmd 的元数据文件中定义后才能实例化。 可执行文件的名称不必与 .winmd 文件名匹配。

在命名空间中,Windows 运行时 类型(不同于标准 C++ 类型)具有私有或公共可访问性。 默认情况下,可访问性是私有的。 仅公共类型对元数据可见,因此可以从可能用 C++ 之外的语言编写的应用程序和组件使用该类型。 通常,可见类型的规则比不可见类型的规则具有更强的限制,因为可见类型无法公开在 .NET 语言或 JavaScript 中不受支持的 C++ 特定的概念。

说明 说明

元数据仅在运行时由 .NET 语言和 JavaScript 使用。 如果一个 C++ 应用程序或组件与另一个 C++ 应用程序或组件(这包括用 C++ 编写的 Windows 组件)通信,则无需在运行时使用元数据。

在私有 ref 类、接口或委托中,不会将成员发送到元数据,即使它们具有公共可访问性。 在公共 ref 类中,您可以独立于成员在源代码中的可访问性控制成员在元数据中的可见性。 与在标准 C++ 中一样,应用最小特权原则;除非成员必须可见,否则不要使成员在元数据中可见。

使用以下访问修饰符控制元数据可见性和源代码可访问性。

修饰符

含义

是否发送到元数据

private

默认可访问性。 与在标准 C++ 中的含义一样。

protected

与在标准 C++ 中的含义一样(在应用程序或组件中以及元数据中)。

public

与在标准 C++ 中的含义一样。

public protected –或- protected public

元数据中的受保护的可访问性,应用程序或组件中的公共可访问性。

protected private private protected

在元数据中不可见;应用程序或组件中的受保护的可访问性。

internal private public

成员在应用程序或组件中是公共的,但在元数据中不可见。

Windows API 由在 Windows::* 命名空间中声明的类型组成。 这些命名空间为 Windows 所保留,因此,不能在其中添加类型。 “对象浏览器”中,您可以在 windows.winmd 文件中查看这些命名空间。 有关这些命名空间的文档,请参见 Windows API

Visual C++ 组件扩展 (C++/CX) 定义这些命名空间中的某些类型作为 Windows 运行时 类型系统投影的一部分。

命名空间

说明

default

包含内置数值和 char16 类型。 这些类型在每个命名空间的范围中,而且从来不需要 using 语句。

平台

包含对应于 Windows 运行时类型(如 Array<T>StringGuidBoolean)的主要公共类型。 另外还包括专用帮助程序类型(如 Platform::Agile<T>Platform::Box<T>)。

Platform::Collections

包含实现 Windows 运行时集合接口 IVectorIMap 等的具体集合类。 这些类型在标头文件 collection.h 而非 platform.winmd 中定义。

Platform::Details

包含编译器使用而不适合公共使用的类型。

显示:
© 2015 Microsoft