uap3:Extension (Windows 10)

Declares an extensibility point for the app.

Element hierarchy

<Package>
<Applications>
<Application>
<Extensions>
<uap3:Extension>

Syntax

<uap3:Extension Category       = "windows.appointmentDataProvider" | 
                                 "windows.emailDataProvider" | 
                                 "windows.contactDataProvider" | 
                                 "windows.appUriHandler" | 
                                 "windows.appExtensionHost" | 
                                 "windows.appExtension"
                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&#39;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:appExecutionAlias
  )?

</uap3:Extension>

Key

          ? optional (zero or one)

Attributes and Elements

Attributes

Attribute Description Data type Required Default value
Category The type of app extensibility point.

This attribute can have one of the following values:

  • windows.appointmentDataProvider
  • windows.emailDataProvider
  • windows.contactDataProvider
  • windows.appUriHandler
  • windows.appExtensionHost
  • windows.appExtension
  • windows.app.ExecutionAlias
 Yes
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
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
ResourceGroup A tag that you can use to group extension activations together for resource management purposes (for example, CPU and memory). The value you can set ResourceGroup is free-form and flexible. See Application@ResourceGroup . An alphanumeric string between 1 and 255 characters in length. Must begin with an alphabetic character. 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
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

This value 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

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:AppExeuctionAlias Declares an app extensibility point of type windows.appExecutionAlias.

 

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
Namespace http://schemas.microsoft.com/appx/manifest/uap/windows10/3

http://schemas.microsoft.com/appx/manifest/uap/windows10/10 (for the uap10 attributes)