uap17：Extension

Description

宣告應用程式的擴充點。

元素階層

<封裝>

<擴充功能>

<uap17：Extension>

Syntax

<uap17:Extension     Category = "windows.packageExtensionHost" | "windows.packageExtension"
    desktop11:AppLifecycleBehavior = "systemManaged" | "unmanaged"
    Executable? = A string between 1 and 256 characters in length that must end with ".exe" and cannot contain these characters: <, >, :, ", |, ?, or *.
    EntryPoint? = A string between 1 and 256 characters in length that cannot start or end with a whitespace character.
    RuntimeType? = A string between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, ", /, \, |, ?, or *.
    StartPage? = A string between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.
    ResourceGroup? = An alphanumeric string between 1 and 255 characters in length. Must begin with an alphabetic character.
    uap10:TrustLevel? = "appContainer" | "mediumIL"
    uap10:RuntimeBehavior? = "windowsApp" | "packagedClassicApp" | "win32App"
    uap10:HostId? = An alphanumeric string between 1 and 255 characters in length. Must begin with an alphabetic character.
    uap10:Parameters? = A string between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.
    uap11:Id? = A string between 1 and 255 characters in length with a non-whitespace character at its beginning and end.
    uap11:Subsystem? = "console" | "windows"
    uap11:SupportsMultipleInstances? = Boolean.
    uap11:ResourceGroup? = An alphanumeric string between 1 and 255 characters in length. Must begin with an alphabetic character.
    uap11:CurrentDirectoryPath? = A string that cannot contain these characters: <, >, |, ?, or *. >
    uap11:Parameters? = A string between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.
    desktop7:CompatMode? = "classic" | "modern"
    desktop7:Scope? = "machine" | "user"
>
<!-- Child elements -->
  PackageExtensionHost
  PackageExtension
</uap17:Extension>

答案

? 選擇性 (零或一個)

屬性

屬性	描述	資料類型	必要
類別	封裝擴充點的類型。	下列其中一個值：“windows.packageExtensionHost” 、 “windows.packageExtension”	Yes
desktop11：AppLifecycleBehavior	允許應用程式覆寫與延伸模組運行時間行為相關聯的生命周期行為。 RuntimeBehavior 為 “windowsApp” 的應用程式或擴充功能隱含地具有 “systemManaged” 的 AppLifecycleBehavior。 RuntimeBehavior 為 “packagedClassicApp” 或 “win32App” 的應用程式或擴充功能隱含地具有 “Unmanaged” 的 AppLifecycleBehavior	下列其中一個值：「systemManaged」、“Unmanaged”	No
可執行檔	默認啟動可執行檔。	下列其中一個值：長度必須以 「.exe」 結尾的 1 到 256 個字元之間的字串，不能包含下列字元：、、：><、、“、,, ?, 或 *。	No
EntryPoint	可啟用的類別識別碼。	長度介於 1 到 256 個字元之間的字串，不能以空格符開頭或結尾。	No
RuntimeType	運行時間提供者。	下列其中一個值：長度介於 1 到 255 個字元的字串，長度不能以句號開頭或結尾，或包含下列字元： <、、 >：、、、“、/、、,, ?, 或 *。	No
StartPage	處理擴充點的網頁	下列其中一個值：長度介於 1 到 256 個字元之間的字串，不能包含下列字元：、、>：<、“、,, ?, 或 *。	No
ResourceGroup	選擇性標籤，用來將擴充功能啟用群組在一起，以供資源管理之用 (例如 CPU 和記憶體) 。	長度介於 1 到 255 個字元之間的英數位元字串。 必須以字母字元開頭。	No
uap10：TrustLevel	指定延伸模組的信任層級。	下列其中一個值：“appContainer”、“ ”mediumIL”	No
uap10：RuntimeBehavior	指定延伸模組的運行時間行為。	下列其中一個值：“windowsApp”、“packagedClassicApp”、“ ”win32App”	No
uap10：HostId	指定擴充功能的主機運行時間標識碼。	長度介於 1 到 255 個字元之間的英數位元字串。 必須以字母字元開頭。	No
uap10：Parameters	包含要傳遞至延伸模組的命令行參數。 僅支援傳統型應用程式。	長度介於 1 到 32767 個字元之間的字串，其開頭和結尾為非空格符。	No
uap11：Id	延伸模組的標識碼。 封裝中所有延伸模組的標識碼都必須是唯一的。	長度介於 1 到 255 個字元的字串，其開頭和結尾為非空格符。	No
uap11：子系統	此屬性繼承自基底延伸模組語法。 除了語法驗證之外，會忽略此值。	下列其中一個值：“console”、“ ”windows”	No
uap11：SupportsMultipleInstances	指定實例是否應該在不同的進程中執行。 預設值為 false。	布林值。	No
uap11：ResourceGroup	標記，可用來將擴充功能啟用群組在一起，以供資源管理之用 (例如 CPU 和記憶體) 。 您可以設定 ResourceGroup 的值是自由格式且有彈性的。	長度介於 1 到 255 個字元之間的英數位元字串。 必須以字母字元開頭。	No
uap11：CurrentDirectoryPath	指定應用程式進程啟動時的初始目錄。 此屬性支持宏。 如需詳細資訊，請參閱 套件指令清單架構中的宏。	下列其中一個值：不能包含下列字元的字串： <、 >、,, ?, 或 *。 >	No
uap11：Parameters	包含要傳遞至延伸模組的命令行參數。 僅支援傳統型應用程式。 此屬性支持宏。 如需詳細資訊，請參閱 套件指令清單架構中的宏。	長度介於 1 到 32767 個字元之間的字串，其開頭和結尾為非空格符。	No
desktop7：CompatMode	指定此延伸模組的資訊是以傳統方式向 Windows 註冊， (例如，未封裝的應用程式會透過登錄) 或以更具範圍的方式向 COM 註冊類型。 預設值為 「modern」。 CompatMode=“classic” 需要 Microsoft.classicAppCompat_8wekyb3d8bbwe 功能。	下列其中一個值：“classic”、“ ”modern”	No
desktop7：Scope	指定只有以使用者身分註冊此套件的使用者 (使用者) 執行的其他應用程式，還是計算機上所有用戶和服務都能看見註冊， (計算機) 。 預設值為 「user」。 Scope=“machine” 需要 Microsoft.classicAppCompatElevated_8wekyb3d8bbwe 功能。	下列其中一個值：“machine”、“user”	No

子元素

元素	Description
PackageExtensionHost	宣告 windows.appExtensionHost 類型的應用程式擴充點。
PackageExtension	宣告 windows.appExtension 類型的應用程式擴充點。

備註

需求

前置詞	值
uap17	http://schemas.microsoft.com/appx/manifest/uap/windows10/17
uap10	http://schemas.microsoft.com/appx/manifest/uap/windows10/10
uap11	http://schemas.microsoft.com/appx/manifest/uap/windows10/11
desktop7	http://schemas.microsoft.com/appx/manifest/desktop/windows10/7