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 設計工具的目標 SDK 版本為何，下列程式碼只會在 XAML 設計工具內執行時執行。 我們建議針對大部分的使用者進行這項檢查。

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.
}

備註

從任何 XAML 設計工具版本內執行的使用者程式碼呼叫時，Windows.ApplicationModel.DesignMode.DesignMode.DesignModeEnabled會傳回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 Creators Update SDK 或更早版本為目標的 XAML 設計工具	以 Windows 10 Fall Creators Update SDK 或更新版本為目標的 Xaml 設計工具
CoreWindow	❌	✔️
CoreDispatcher	❌	✔️
執行緒模型	單線程 Apartment (STA)	應用程式單一執行緒 Apartment (ASTA)
.NET Framework	桌面	核心
UI 組合支援	❌	✔️
壓克力筆刷支援	❌	✔️
Fluent 設計系統	限制	完整支援

另請參閱

• DesignModeEnabled