共用方式為


desktop7:Extension (在套件/應用程式中)

宣告應用程式的擴充點。

元素階層

<套件>

     <應用程式>

          <應用程式>

               <擴充功能>

                    <desktop7:Extension>

語法

<desktop7:Extension
  Category = 'A string that can have one of the following values: "windows.approvedShellExtension", "windows.controlPanelItem", "windows.service", "windows.mailProvider", "windows.shortcut", "windows.applicationRegistration", "windows.desktopAppMigration", "windows.systemFileAssociation", "windows.shadowCopyExcludeFiles", or "windows.errorReporting".'
  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 *.'
  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 alphanumeric string with a value between 1 and 255 characters in length. Must begin with a letter.'
  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.' 
  uap11:Id = 'An optional string with a value between 1 and 255 characters in length with a non-whitespace character at its beginning and end.'
  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 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 = 'An optional string the can have one of the following values: "classic" or "modern".'
  desktop7:Scope = 'An optional string that can have one of the following values: "machine" or "user".'>

  <!-- Child elements -->
  desktop7:ApprovedShellExtension?
  desktop7:ControlPanelItem?
  desktop7:Service?
  desktop7:MailProvider?
  desktop7:Shortcut?
  desktop7:ApplicationRegistration?
  desktop7:DesktopAppMigration?
  desktop7:SystemFileAssociation?
  desktop7:ShadowCopyExcludeFiles?
  desktop7:ErrorReporting?

</desktop7:Extension>

鑰匙

? 選擇性 (零或一個)

屬性和元素

屬性

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

子專案

子專案 描述
desktop7:ApprovedShellExtension 指定安裝時,應該將殼層延伸模組新增至核准的殼層擴充功能清單。
desktop7:ControlPanelItem 將延伸模組註冊為控制面板專案。
desktop7:Service 指定隨應用程式一起安裝和註冊的服務。
desktop7:MailProvider 指定隨應用程式一起安裝和註冊的服務。
desktop7:Shortcut 建立檔案的快捷方式。
desktop7:ApplicationRegistration 註冊應用程式。
desktop7:DesktopAppMigration 指定磚和釘選的應用程式移轉專案集。
desktop7:SystemFileAssociation 註冊應用程式的系統檔案關聯。
desktop7:ShadowCopyExcludeFiles 指定要由磁碟區陰影複製服務 (VSS) 排除的一組檔案。
desktop7:ErrorReporting 指定要由磁碟區陰影複製服務 (VSS) 排除的一組檔案。

父元素

Parent 元素 描述
延伸模組 (類型: CT_ApplicationExtensions) 定義應用程式的一或多個擴充點。

要求

專案 價值
Namespace http://schemas.microsoft.com/appx/manifest/desktop/windows10/7
uap10 http://schemas.microsoft.com/appx/manifest/uap/windows10/10
最低 OS 版本 Windows 10 (組建 19645)