Launcher 類別

定義

命名空間:

Windows.System

啟動與指定檔案或 URI 相關聯的預設應用程式。

public ref class Launcher abstract sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Launcher final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public static class Launcher

Public Class Launcher

繼承

Object Platform::Object IInspectable Launcher

屬性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 需求

裝置系列	Windows 10 (已於 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v1.0 引進)

範例

啟動應用程式套件中包含的檔案

請參閱 LaunchFileAsync (IStorageFile) 主題中的程式碼範例。

啟動 URI

請參閱 LaunchUriAsync (Uri) 主題中的程式碼範例。

以警告對話方塊啟動

此範例會呼叫 launchUriAsync (Uri、LauncherOptions) 以警告啟動 URI。 使用 treatAsUntrusted 屬性來指出系統應該顯示警告。

注意

如果是使用 JavaScript 的 Windows 應用程式，如果已設定 treatAsUntrusted屬性，而且您使用錨點元素啟動 URI，請在事件處理常式中呼叫preventDefault。

function linkClickHandler(eventInfo) {
    var link = eventInfo.target;
    if (eventInfo.srcElement && (
        (eventInfo.type === "click") ||
        (eventInfo.type === "keydown" && (
        eventInfo.keyCode === WinJS.Utilities.Key.enter ||
        eventInfo.keyCode === WinJS.Utilities.Key.space)))) {
        eventInfo.preventDefault();
        if (link.href.indexOf("ms-appx") > -1) {
            WinJS.Navigation.navigate(link.href);
        }
        else if (link.href.indexOf("http") > -1) {
            // Create a Uri object from a URI string 
            var uri = new Windows.Foundation.Uri(link.href);
            var options = new Windows.System.LauncherOptions();
            // Launch the URI with a warning prompt
            options.treatAsUntrusted = true;
            // Launch the URI
            Windows.System.Launcher.launchUriAsync(uri, options).then(
                function (success) {
                    if (success) {
                        // URI launched
                    } else {
                        // URI launch failed
                    }
                });
        }
    }
}

備註

注意

這個類別不是敏捷式的，這表示您需要考慮其執行緒模型和封送處理行為。 如需詳細資訊，請參閱執行緒和封送處理 (C++/CX) 和在多執行緒環境中使用 Windows 執行階段 物件 (.NET) 。

版本歷程記錄

Windows 版本	SDK 版本	已新增值
1607	14393	FindAppUriHandlersAsync
1607	14393	LaunchUriForResultsForUserAsync (User，Uri，LauncherOptions)
1607	14393	LaunchUriForResultsForUserAsync (User，Uri，LauncherOptions，ValueSet)
1607	14393	LaunchUriForUserAsync (User，Uri)
1607	14393	LaunchUriForUserAsync (User，Uri，LauncherOptions)
1607	14393	LaunchUriForUserAsync (User，Uri，LauncherOptions，ValueSet)
1607	14393	QueryAppUriSupportAsync (Uri)
1607	14393	QueryAppUriSupportAsync (Uri，String)
1809	17763	LaunchFolderPathAsync (String)
1809	17763	LaunchFolderPathAsync (String，FolderLauncherOptions)
1809	17763	LaunchFolderPathForUserAsync (User，String)
1809	17763	LaunchFolderPathForUserAsync (User，String，FolderLauncherOptions)

方法

FindAppUriHandlersAsync(Uri)	列舉裝置上的統一資源識別項 (URI) 處理常式。
FindFileHandlersAsync(String)	列舉裝置上的檔案處理常式。
FindUriSchemeHandlersAsync(String)	列舉裝置上的配置處理常式。
FindUriSchemeHandlersAsync(String, LaunchQuerySupportType)	列舉裝置上的配置處理常式。
LaunchFileAsync(IStorageFile)	啟動與指定檔案相關聯的預設應用程式。
LaunchFileAsync(IStorageFile, LauncherOptions)	使用指定的選項，啟動與指定檔案相關聯的預設應用程式。
LaunchFolderAsync(IStorageFolder)	啟動檔案總管並顯示指定資料夾的內容。
LaunchFolderAsync(IStorageFolder, FolderLauncherOptions)	使用指定的選項啟動檔案總管，並顯示指定資料夾的內容。
LaunchFolderPathAsync(String)	啟動檔案總管並顯示指定資料夾的內容。
LaunchFolderPathAsync(String, FolderLauncherOptions)	使用指定的選項啟動檔案總管，並顯示指定資料夾的內容。
LaunchFolderPathForUserAsync(User, String)	啟動檔案總管並顯示指定資料夾的內容。
LaunchFolderPathForUserAsync(User, String, FolderLauncherOptions)	使用指定的選項啟動檔案總管，並顯示指定資料夾的內容。
LaunchUriAsync(Uri)	啟動與指定 URI 之 URI 配置名稱相關聯的預設應用程式。
LaunchUriAsync(Uri, LauncherOptions)	使用指定的選項，啟動與 URI 配置名稱相關聯的預設應用程式，或由 ContentType 為指定 URI 所指定的應用程式。
LaunchUriAsync(Uri, LauncherOptions, ValueSet)	使用指定的選項和輸入資料，啟動與指定 URI 配置名稱相關聯的預設應用程式。
LaunchUriForResultsAsync(Uri, LauncherOptions)	使用指定的選項，以非同步方式啟動與指定 URI 配置名稱相關聯的預設應用程式。
LaunchUriForResultsAsync(Uri, LauncherOptions, ValueSet)	使用指定的選項和輸入資料，以非同步方式啟動與指定 URI 配置名稱相關聯的預設應用程式。
LaunchUriForResultsForUserAsync(User, Uri, LauncherOptions)	使用指定的選項，以非同步方式啟動與指定 URI 配置名稱相關聯的預設應用程式，並提供特定的 User 作為內容。
LaunchUriForResultsForUserAsync(User, Uri, LauncherOptions, ValueSet)	使用指定的選項和輸入資料，以非同步方式啟動與指定 URI 配置名稱相關聯的預設應用程式，並提供特定 使用者 做為內容。
LaunchUriForUserAsync(User, Uri)	啟動與指定 URI 之 URI 配置名稱相關聯的預設多使用者應用程式，並提供特定 使用者 做為內容。
LaunchUriForUserAsync(User, Uri, LauncherOptions)	使用指定的選項啟動與指定 URI 配置名稱相關聯的預設多使用者應用程式，並提供特定 使用者 做為內容。
LaunchUriForUserAsync(User, Uri, LauncherOptions, ValueSet)	使用指定的選項和輸入資料，啟動與指定 URI 配置名稱相關聯的預設多使用者應用程式，並提供特定 使用者 做為內容。
QueryAppUriSupportAsync(Uri)	以非同步方式查詢是否有應用程式可以處理指定的 URI。
QueryAppUriSupportAsync(Uri, String)	以非同步方式查詢指定的應用程式是否可以處理指定的 URI。
QueryFileSupportAsync(StorageFile)	以非同步方式查詢是否可以為指定的檔案啟用應用程式。
QueryFileSupportAsync(StorageFile, String)	以非同步方式查詢是否可針對指定的檔案啟用具有指定套件名稱的應用程式。
QueryUriSupportAsync(Uri, LaunchQuerySupportType)	以非同步方式查詢是否可以針對指定的 URI 和啟動類型啟用應用程式。
QueryUriSupportAsync(Uri, LaunchQuerySupportType, String)	以非同步方式查詢是否可以針對指定的 URI、啟動類型和套件名稱啟用應用程式。

另請參閱

• LauncherOptions
• LauncherUIOptions
• 啟動檔案的預設應用程式
• 啟動 URI 的預設應用程式
• 關聯啟動範例
• 檔案類型與 URI 的指導方針