Xamarin.Essentials：應用程式主題

RequestedTheme API 是 類別的一部分，AppInfo並提供系統針對執行中應用程式要求的主題資訊。

開始使用

若要開始使用此 API，請閱讀 入門指南Xamarin.Essentials，以確保連結庫已正確安裝並設定在您的專案中。

使用 RequestedTheme

在類別中新增 的 Xamarin.Essentials 參考：

using Xamarin.Essentials;

取得佈景主題資訊

可透過下列 API 來偵測所要求的應用程式佈景主題：

AppTheme appTheme = AppInfo.RequestedTheme;

這將會提供系統針對您的應用程式目前所要求的佈景主題。 傳回值將會是下列其中一個：

• [未指定]
• 淺色
• 深色

如果作業系統沒有特定的使用者介面樣式可供要求，將會傳回「未指定」。 此情況的其中一個範例，是執行早於 13.0 之 iOS 版本的裝置。

平台實作特性

Android

Android 會使用設定模式來指定要向使用者要求的佈景主題類型。 根據 Android 的版本而定，其可能會由使用者變更，或是在啟用節約耗電量模式時變更。

您可以在官方的深色佈景主題 Android 文件 \(英文\) 中深入閱讀。

iOS

針對早於 13.0 的 iOS 版本，將一律會傳回「未指定」

UWP

必須在UI線程上呼叫呼叫 ， RequestedTheme 否則會擲回例外狀況。

UWP 應用程式將會遵守您在 RequestedTheme 下 UWP App.xaml 中的設定。 如果設定為特定主題， Xamarin.Essentials 一律會傳回此設定。 若要使用作業系統的動態主題，請將此節點從您的應用程式中移除，然後在執行您的應用程式時，它會傳回使用者於 Windows 設定中設定的主題（設定 > 個人化>色彩 > 選擇您的預設應用程式模式）。

您可以在 UWP 所要求佈景主題文件 \(英文\) 中深入閱讀。

API

• AppInfo 原始程式碼
• AppInfo API 文件

相關影片

在 Channel 9 與 YouTube 上尋找更多 Xamarin 影片。