啟動 [預設應用程式設定] 頁面
了解如何使用 ms-settings URI 方案啟動 Windows 設定應用程式以顯示應用程式中的預設應用程式設定頁面。
Windows 定義了一組 URI,允許應用程式啟動 Windows 設定應用程式並顯示特定的設定頁面。 本文介紹如何將 Windows 設定應用程式直接啟動到預設應用程式設定頁面,以及 (選用) 直接導覽至指定預設應用程式的設定。 如需詳細資訊,請參閱啟動 Windows 設定應用程式。
預設應用程式設定 URL
ms-settings:defaultapps
會啟動 Windows 設定應用程式,並流覽至 [預設應用程式設定] 頁面。 從 Windows 11 版本 21H2(含 2023-04 累積更新)、22H2(含 2023-04 累積更新)和 23H2 或更新版本開始,您可以附加逸出 URI 格式的其他查詢字元串參數,直接啟動特定應用程式的設定頁面。
共有三個查詢字串參數。 要使用的查詢字串參數取決於應用程式的安裝方式。
查詢字串參數 | 要傳遞的值 |
---|---|
registeredAppUser | HKEY_CURRENT_USER\Software\RegisteredApplications 中的命名值 當應用程式按使用者安裝且應用程式的註冊寫入 HKEY_CURRENT_USER\Software\RegisteredApplications 時使用。 |
registeredAppMachine | HKEY_LOCAL_MACHINE\Software\RegisteredApplications 中的命名值 當應用程式安裝在每台電腦上並且應用程式的註冊寫入 HKEY_LOCAL_MACHINE\Software\RegisteredApplications 時使用。 |
registeredAUMID | 應用程式使用者模型識別碼 當應用程式使用聲明應用程式處理檔案類型 (uap:FileTypeAssociation) 或 URI 方案 (uap:Protocol) 的清單向套件管理器註冊時使用。 |
注意
若要使 RegisteredAUMID 查詢字串參數在作業系統升級後正常運作,應用程式可能需要在其清單中增加其 TargetDeviceFamily...MaxVersionTested 值。 這將確保為用戶重新索引應用程式,進而更新用於透過協議激活處理深層連結的適當定義。 MaxVersionTested 應更新為 10.0.22000.1817
Windows 11 版本 21H2 或 10.0.22621.1555
Windows 11 版本 22H2。
在下列範例中,會呼叫 LaunchUriAsync
來啟動 Windows 設定 應用程式。 ms-settings:defaultapps
Uri 會指定應該顯示 [預設應用程式設定] 頁面。 接下來,決定應該啟動的應用程式。 例如,「Microsoft Edge」 是由應用程式在 HKEY_LOCAL_MACHINE\Software\RegisteredApplications 中註冊。 由於它是每台電腦安裝的應用程式,registeredAppMachine
是應使用的查詢字串參數。 可選的查詢字串參數 registeredAppMachine
設定為註冊名稱,透過呼叫 Url.EscapeDataString
轉義,以指定應顯示的 Microsoft Edge 的頁面。
private async void LaunchSettingsPage_Click(object sender, RoutedEventArgs e)
{
bool result = await Windows.System.Launcher.LaunchUriAsync(new Uri("ms-settings:defaultapps?registeredAppMachine=" + Uri.EscapeDataString(("Microsoft Edge")));
}
bool result = co_await Windows::System::Launcher::LaunchUriAsync(Windows::Foundation::Uri(L"ms-settings:defaultapps?registeredAppMachine=" + Uri::EscapeDataString(L"Microsoft Edge")));