DesignMode.DesignMode2Enabled 属性

定义

命名空间:

Windows.ApplicationModel

用于在面向 Windows 10 Fall Creators Update SDK 或更高版本的 XAML 设计器中启用或禁用用户代码。

public:
 static property bool DesignMode2Enabled { bool get(); };

static bool DesignMode2Enabled();

public static bool DesignMode2Enabled { get; }

var boolean = DesignMode.designMode2Enabled;

Public Shared ReadOnly Property DesignMode2Enabled As Boolean

属性值

Boolean

bool

如果从面向Windows 10 Fall Creators Update或更高版本的 XAML 设计器内运行的代码调用，则为 True;否则为 false。

Windows 要求

设备系列	Windows 10 Fall Creators Update (在 10.0.16299.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v5.0 中引入)

示例

以下代码仅在 XAML 设计器中运行时执行，而不考虑 XAML 设计器面向的 SDK 版本。 我们建议大多数用户使用此检查。

if (Windows.ApplicationModel.DesignMode.DesignModeEnabled)
{
    // Code to execute when running inside a XAML designer, regardless of the SDK the designer targets.
}

以下代码仅在面向 Windows 10 Fall Creators Update SDK 或更高版本的 XAML 设计器中运行时执行。

if (Windows.ApplicationModel.DesignMode.DesignMode2Enabled)
{
    // Code to execute when running inside a XAML designer that targets the Fall Creators Update SDK, or later.
}

注解

Windows.ApplicationModel.DesignMode.DesignModeEnabled 在从任何 XAML 设计器版本内运行的用户代码调用时返回 true ，而不管你面向哪个 SDK 版本。 对于大多数用户，建议使用此检查。

从 Windows 10 Fall Creators Update 开始，Visual Studio 提供了面向 Windows 10 Fall Creators Update 及更高版本的新 XAML 设计器。

使用 Windows.ApplicationModel.DesignMode.DesignMode2Enabled 区分仅针对Windows 10 Fall Creators Update SDK 或更高版本的 XAML 设计器启用的功能的代码。

下表列出了 XAML 设计器支持的功能差异，具体取决于 XAML 设计器面向的 Windows 10 SDK 版本。

	面向Windows 10 创意者更新 SDK 或更早版本的 XAML 设计器	面向Windows 10 Fall Creators Update SDK 或更高版本的 Xaml 设计器
CoreWindow	❌	✔️
CoreDispatcher	❌	✔️
线程模型	单线程单元 (STA)	应用程序单线程单元 (ASTA)
.NET Framework	桌面	核心
UI 组合支持	❌	✔️
亚克力画笔支持	❌	✔️
Fluent 设计系统	受限制	完全支持

另请参阅

• DesignModeEnabled