uap3:Extension (Windows 10)
Declares an extensibility point for the app.
< UAP3:Extension >
Syntax
<uap3:Extension Category = "windows.appointmentDataProvider" |
"windows.emailDataProvider" |
"windows.contactDataProvider" |
"windows.appUriHandler" |
"windows.appExtensionHost" |
"windows.appExtension" |
"windows.protocol" |
"windows.fileTypeAssociation" |
Executable? = A string 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 isn't
specified, the EntryPoint defined for the app is used.
EntryPoint? = A string 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? = 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? = String value. Can be one of the following: "appContainer", "mediumIL".
uap10:RuntimeBehavior? = String value. Can be one of the following: "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. >
<!-- Child elements -->
( uap3:appointmentDataProvider
| uap3:emailDataProvider
| uap3:contactDataProvider
| uap3:appUriHandler
| uap3:appService
| uap3:appExecutionAlias
| uap3:fileTypeAssociations
)?
</uap3:Extension>
Key
? optional (zero or one)
Attributes and Elements
Attributes
| Attribute | Description | Data type | Required |
|---|---|---|---|
| Category | The category of the extension. | One of the following: "windows.appExtensionHost", "windows.appExtension", "windows.appUriHandler", "windows.appointmentDataProvider", "windows.emailDataProvider", "windows.contactDataProvider", "windows.appExecutionAlias", "windows.appService", "windows.protocol", "windows.fileTypeAssociations" | Yes |
| Executable | The default launch executable. | A string 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 isn't specified, the EntryPoint defined for the app is used. | No |
| EntryPoint | The activatable class ID. | A string 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. | No |
| RuntimeType | The runtime provider. This attribute is used typically when there are mixed frameworks in an app. | A string between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, ", /, , |, ?, or *. | No |
| StartPage | The web page that handles the extensibility point. | A string between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *. | No |
| ResourceGroup | The logical container where resources are managed. | An alphanumeric string between 1 and 255 characters in length. | No |
| uap10:TrustLevel | Specifies the trust level of the extension. | String value. Can be one of the following: "appContainer", "mediumIL". | No |
| uap10:RuntimeBehavior | Specifies the run time behavior of the extension. | String value. Can be one of the following: "windowsApp", "packagedClassicApp", "win32App". | No |
| uap10:HostId | Specifies the app ID of the host app for the extension. | An alphanumeric string between 1 and 255 characters in length. Must begin with an alphabetic character. | No |
| uap10:Parameters | Contains command line parameters to pass to the extension. Only supported for desktop apps that have package identity. | A string between 1 and 32767 characters in length with a non-whitespace character at its beginning and end. | No |
| previewappcompat:CompatMode | Specifies the compatibility mode when viewing application previews. | A string value that can be one of the following: "classic", "modern". | No |
| previewappcompat:Scope | Contains paraeters to manipulate the scope used for application previews. | A string value that can be one of the following: "user", "machine". | No |
| uap11:Id | The unique identifier for the extensibility point. | A string between 1 and 256 characters in length. | No |
| uap11:Subsystem | Specifies the type of system the application will run on. | String value. Can be one of the following: "console", "windows". | No |
| uap11:SupportsMultipleInstances | Specifies whether or not the application supports multiple instances. | Boolean value. | No |
| uap11:Resource Group | The logical container where resources are managed. | An alphanumeric string between 1 and 255 characters in length. | No |
| uap11:CurrentDirectoryPath | Specifies the current directory the of the extensibility point. | A string between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *. | No |
| uap11:Parameters | Contains command line parameters to pass to the extension. Only supported for desktop apps that have package identity. | A string between 1 and 32767 characters in length with a non-whitespace character at its beginning and end. | No |
| desktop7:CompatMode | Specifies the compatibility mode when viewing application previews. | A string value that can be one of the following: "classic", "modern". | No |
| desktop7:Scope | Contains paraeters to manipulate the scope used for application previews. | A string value that can be one of the following: "user", "machine". | No |
Child Elements
| Child Element | Description |
|---|---|
| uap3:AppointmentDataProvider | Declares an app extensibility point of type windows.appointmentDataProvider. |
| uap3:EmailDataProvider | Declares an app extensibility point of type windows.emailDataProvider. |
| uap3:ContactDataProvider | Declares an app extensibility point of type windows.contactDataProvider. |
| uap3:AppUriHandler | Declares an app extensibility point of type windows.appUriHandler. |
| uap3:AppExtensionHost | Declares an app extensibility point of type windows.appExtensionHost. |
| uap3:AppExtension | Declares an app extensibility point of type windows.appExtension. |
| uap3:AppService | Declares an app extensibility point of type windows.appExtension. |
| uap3:AppExeuctionAlias | Declares an app extensibility point of type windows.appExecutionAlias. |
| uap3:Protocol | Declares an app extensibility point of type windows.protocol. |
| uap3:FileTypeAssociations | Declares an app extensibility point of type windows.fileTypeAssociations. |
Parent Elements
| Parent Element | Description |
|---|---|
| Extensions (type: CT_ApplicationExtensions) | Defines one or more extensibility points for the app. |
Examples
<Package ...
xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
IgnorableNamespaces="... uap3">
<Applications>
<Application>
<Extensions>
<uap3:Extension Category="windows.appointmentDataProvider"
EntryPoint="UserDataProvider.AppointmentDataProviderTask">
<uap3:AppointmentDataProvider ServerName="MyDataProvider.PPLE" />
</uap3:Extension>
</Extensions>
</Application>
</Applications>
</Package>
Requirements
| Value | |
|---|---|
| uap3 | http://schemas.microsoft.com/appx/manifest/uap/windows10/3 |
| uap10 | http://schemas.microsoft.com/appx/manifest/uap/windows10/10 |
| previewappcompat | http://schemas.microsoft.com/appx/manifest/preview/windows10/msixappcompatsupport/3 |
| UAP11 | http://schemas.microsoft.com/appx/manifest/uap/windows10/11 |
| Desktop7 | http://schemas.microsoft.com/appx/manifest/desktop/windows10/7 |
Feedback
Submit and view feedback for