共用方式為


desktop:Extension

宣告應用程式的擴充點。

元素階層

<套件>

    <應用程式>

         <\應用>

              <\擴展>

                   <\Desktop:Extension>

Syntax

<desktop:Extension
  Category = 'A string value that can be one of the following values: "windows.fullTrustProcess", "windows.startupTask", "windows.toastNotificationActivation", or "windows.searchProtocolHandler".'
  Executable = 'An optional string with a value between 1 and 256 characters in length that must end with ".exe" and cannot contain these characters: <, >, :, ", |, ?, or *. It specifies the default executable for the extension. If not specified, the executable defined for the app is used.  If specified, the EntryPoint property is also used. If that EntryPoint property isnt specified, the EntryPoint defined for the app is used.'
  EntryPoint = 'An optional string with a value between 1 and 256 characters in length, representing the  task handling the extension. This is normally the fully namespace-qualified name of a Windows Runtime type. If EntryPoint is not specified, the EntryPoint defined for the app is used instead.'
  RuntimeType = 'An optional string with a value between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, ", /, \, |, ?, or *.'
  StartPage = 'An optional string with a value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
  ResourceGroup =  'An optional alphanumeric string with a value between 1 and 255 characters in length. Must begin with a letter.'
  uap10:TrustLevel = 'An optional string that can have one of the following values: "appContainer" or "mediumIL".'
  uap10:RuntimeBehavior = 'An optional string that can have one of the following values: "windowsApp", "packagedClassicApp", or "win32App".'
  uap10:HostId = 'An optional alphanumeric string with a value between 1 and 255 characters in length. Must begin with an alphabetic character.'
  uap10:Parameters = 'An optional string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
  previewappcompat:CompatMode = 'An optional string that can have one of the following values: "classic" or "modern".'
  previewappcompat:Scope = 'An optional string that can be one of the following values: "user" or "machine".'
  uap11:Id = 'An optional string with a value between 1 and 256 characters in length.'
  uap11:Subsystem = 'An optional string that can have one of the following values: "console" or "windows".'
  uap11:SupportsMultipleInstances = 'An optional boolean value.'
  uap11:ResourceGroup = 'An optional alphanumeric string with a value between 1 and 255 characters in length. Must begin with a letter.'
  uap11:CurrentDirectoryPath = 'An optional string with a value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
  uap11:Parameters = 'An optional string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
  desktop7:CompatMode = 'A string that can have one of the following values: "classic" or "modern".'
  desktop7:Scope = 'A string that can have one of the following values: "machine" or "user".' >

  <!-- Child elements -->
  desktop:FullTrustProcess?
  desktop:StartupTask?
  desktop:ToastNotificationActivation?
  desktop:SearchProtocolHandler?

</desktop:Extension>

答案

? 選擇性 (零或一個)

屬性和元素

屬性

屬性 描述 資料類型 必要 預設值
類別 延伸模組的類別。 字串值,可以是下列其中一個值: windows.fullTrustProcesswindows.startupTaskwindows.toastNotificationActivationwindows.searchProtocolHandler Yes
可執行檔 默認啟動可執行檔。 長度介於 1 到 256 個字元的選擇性字串,長度必須以 .exe 結尾且不能包含下列字元:<、、>、、:、、"|?*。 它會指定延伸模組的預設可執行檔。 如果未指定,則會使用為應用程式定義的可執行檔。 如果指定,也會使用 EntryPoint 屬性。 如果未指定 EntryPoint 屬性,則會使用為應用程式定義的 EntryPoint。 No
EntryPoint 可啟用的類別識別碼。 長度介於 1 到 256 個字元之間的選擇性字串,表示處理延伸的工作。 這必須符合 Windows 執行階段類型的完整命名空間名稱。 如果未指定 EntryPoint,則會改用為應用程式定義的 EntryPoint。 No
RuntimeType 運行時間提供者。 當應用程式中有混合架構時,通常會使用這個屬性。 長度介於 1 到 255 個字元之間的選擇性字串,長度不能以句點開頭或結尾,或包含下列字元:<、、\:/|">? 或 。* No
StartPage 處理擴充點的網頁 長度介於 1 到 256 個字元之間的選擇性字串,不能包含下列字元:<、、、>:"|?* No
uap10:TrustLevel 指定延伸模組的信任層級。 可具有下列其中一個值的選擇性字串: appContainermediumIL No
uap10:RuntimeBehavior 指定延伸模組的運行時間行為。 可具有下列其中一個值的選擇性字串: windowsApppackagedClassicAppwin32App No
uap10:HostId 指定擴充功能的主機運行時間標識碼。 長度介於 1 到 255 個字元之間的選擇性英數位元字串。 必須以字母字元開頭。 No
uap10:Parameters 包含要傳遞至延伸模組的命令行參數。 僅支援具有套件身分識別的桌面應用程式。 長度介於 1 到 32767 個字元的選擇性字串,其開頭和結尾為非空格符。 No
uap11:Id 延伸模組的標識碼。 套件中所有延伸模組的標識碼都必須是唯一的。 長度介於 1 到 255 個字元的選擇性字串,其開頭和結尾具有非空格符。 No
uap11:子系統 此屬性繼承自基底延伸模組語法,不適用於 com4 延伸模組。 除了語法驗證之外,也會忽略此值。 可具有下列其中一個值的選擇性字串: 控制台視窗 No
uap11:SupportsMultipleInstances 指定實例是否應該在不同的進程中執行。 預設值為 false。 選擇性布爾值。 No
uap11:ResourceGroup 標記,可用來將擴充功能啟用群組在一起,以供資源管理之用 (,例如 CPU 和記憶體) 。 您可以設定 ResourceGroup 的值是自由格式且有彈性。 請參閱 Application@ResourceGroup 長度介於 1 到 255 個字元之間的選擇性英數位元字串。 必須以字母開頭。 No
uap11:CurrentDirectoryPath 指定應用程式進程啟動時的初始目錄。 此屬性支持宏。 如需詳細資訊,請參閱 套件指令清單架構中的宏 無法包含下列字元的選擇性字串:<、、、>|?*。 > No
uap11:Parameters 此屬性繼承自基底延伸模組語法,不適用於 com4 延伸模組。 除了語法驗證之外,也會忽略此值。 此屬性支持宏。 如需詳細資訊,請參閱 套件指令清單架構中的宏 長度介於 1 到 32767 個字元的選擇性字串,其開頭和結尾為非空格符。 No
desktop7:CompatMode 指定此延伸模組的資訊是以傳統方式向 Windows 註冊, (例如,透過登錄) 或以更具範圍的方式向 COM 註冊未封裝的應用程式註冊類型。 預設值為 「modern」。 CompatMode=“classic” 需要 Microsoft.classicAppCompat_8wekyb3d8bbwe 功能。 的選擇性字串可以有下列其中一個值: 傳統新式 No
desktop7:Scope 指定註冊是否只有以使用者身分註冊 (使用者) 執行的其他應用程式,或是否對 (計算機上的所有使用者和服務顯示註冊) 。 預設值為 「user」。 Scope=“machine” 需要 Microsoft.classicAppCompatElevated_8wekyb3d8bbwe 功能。 可具有下列其中一個值的選擇性字串: 計算機使用者 No

子元素

子項目 描述
FullTrustProcess 表示在完全信任中執行的桌面進程。
StartupTask 表示在應用程式啟動期間執行的桌面進程。
ToastNotificationActivation 允許在應用程式內接收快顯通知。
SearchProtocolHandler 表示桌面進程會處理應用程式的搜尋通訊協定。

父元素

父元素 描述
延伸模組 宣告封裝的擴充點。

備註

需求

Item
命名空間 http://schemas.microsoft.com/appx/manifest/foundation/windows10
uap10 http://schemas.microsoft.com/appx/manifest/uap/windows10/10
OS 最低版本 Windows 10 版本 1607 (組建 14393)