desktop2：Extension (in Package/Applications)
宣告應用程式的擴充點。
元素階層
<desktop2:Extension>
Syntax
<desktop2:Extension
Category = 'A string that can have one of the following values: "windows.appPrinter", "windows.searchFilterHandler", "windows.searchPropertyHandler", or "windows.mailProvider".'
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 be one of the following values: "appContainer" or "mediumIL".'
uap10:RuntimeBehavior = 'An optional string that can be 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 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 -->
desktop2:AppPrinter?
desktop2:SearchFilterHandler?
desktop2:SearchPropertyHandler?
desktop2:DesktopEventLogging?
desktop2:FirewallRules?
</desktop2:Extension>
答案
? 選擇性 (零或一個)
屬性和元素
屬性
| 屬性 | 描述 | 資料類型 | 必要 | 預設值 |
|---|---|---|---|---|
| 類別 | 延伸模組的類別。 | 可以具有下列其中一個值的字串： windows.appPrinter、 windows.searchFilterHandler、 windows.searchPropertyHandler 或 windows.mailProvider。 | 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 | 指定延伸模組的信任層級。 | 可以是下列其中一個值的選擇性字串： 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：子系統 | 此屬性繼承自基底延伸模組語法，不適用於 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 |
子元素
| 子項目 | 描述 |
|---|---|
| AppPrinter | 可讓您在 Windows 傳統型橋接器 應用程式中安裝軟體檔案印表機。 |
| SearchFilterHandler | 讓 Windows 傳統型橋接器 應用程式註冊 IFilters 以擷取檔案屬性以進行搜尋。 |
| SearchPropertyHandler | 讓 Windows 傳統型橋接器 應用程式在您的系統上安裝屬性處理程式。 |
| DesktopEventLogging | 讓 Windows 傳統型橋接器 應用程式註冊 Windows 事件記錄。 |
| FirewallRules | 指定 Windows 傳統型橋接器 應用程式所使用的防火牆例外規則。 |
父元素
| 父元素 | 描述 |
|---|---|
| 延伸模組 | 定義應用程式的一或多個擴充點。 |
備註
windows.mailProvider 是空的延伸模組宣告，這是郵件應用程式的進入點，可微調正確的 .dll 來處理郵件 API 要求。 這必須在完全信任應用程式中使用。
規格需求
| Item | 值 |
|---|---|
| 命名空間 | http://schemas.microsoft.com/appx/manifest/desktop/windows10/2 |
| uap10 | http://schemas.microsoft.com/appx/manifest/uap/windows10/10 |
| OS 最低版本 | Windows 10 版本 1703 (組建 15063) |