uap3:Extension (Windows 10)

Dichiara un punto di estendibilità per l'app.

<Pacchetto>

      <Applicazioni>

            <Applicazione>

                 <\uap3:Extension>

Sintassi

<uap3:Extension
    Category = 'A string that can be one of the following values: "windows.appointmentDataProvider", "windows.emailDataProvider", "windows.contactDataProvider", "windows.appUriHandler", "windows.appExtensionHost", "windows.appExtension", "windows.protocol", "windows.fileTypeAssociation".' |
    Executable = 'A string with an optional value between 1 and 256 characters in length, that must end with ".exe", and cannot contain the following characters: <, >, :, ", |, ?, or *. 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 the EntryPoint property is not specified, the EntryPoint defined for the app is used.'
    EntryPoint = 'A string with an optional value between 1 and 256 characters in length. Represents the task handling the extension (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 with an optional value between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, ", /, \, |, ?, or *.'
    StartPage = 'A string with an optional value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
    ResourceGroup = 'An alphanumeric string with an optional value between 1 and 255 characters in length. Must begin with a letter.'
    uap10:TrustLevel = 'An optional string value. If specified, it must be either "appContainer" or "mediumIL".'
    uap10:RuntimeBehavior  = 'An optional string value. If specified, it must be one of the following values:  "windowsApp", "packagedClassicApp", or "win32App".'
    uap10:HostId = 'An alphanumeric string with an optional value between 1 and 255 characters in length. Must begin with an letter.'
    uap10:Parameters = 'A string with an optional 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 -->
    uap3:appointmentDataProvider?
    uap3:emailDataProvider?
    uap3:contactDataProvider?
    uap3:appUriHandler?
    uap3:appService?
    uap3:appExecutionAlias?
    uap3:fileTypeAssociation?

</uap3:Extension>

Chiave

? facoltativo (zero o uno)

Attributi ed elementi

Attributi

Attributo	Descrizione	Tipo di dati	Obbligatoria	Valore predefinito
Categoria	Tipo di punto di estendibilità del pacchetto.	Stringa che può avere uno dei valori seguenti: windows.appointmentDataProvider, windows.emailDataProvider, windows.contactDataProvider, windows.appUriHandler, windows.appExtensionHost, windows.appExtensionHost, windows.protocol, windows.fileTypeAssociation.	Sì
EntryPoint	ID classe activatable.	Stringa con un valore compreso tra 1 e 256 caratteri in lunghezza. Rappresenta l'attività che gestisce l'estensione (normalmente il nome completo dello spazio dei nomi di un tipo di Windows Runtime). Se EntryPoint non viene specificato, viene invece usato EntryPoint definito per l'app.	No
File eseguibile	Eseguibile di avvio predefinito.	Stringa con un valore compreso tra 1 e 256 caratteri in lunghezza, che deve terminare con .exee non può contenere questi caratteri: "<:|>?, o .* Specifica il file eseguibile predefinito per l'estensione. Se non specificato, viene usato il file eseguibile definito per l'app. Se specificato, viene usata anche la proprietà EntryPoint. Se la proprietà EntryPoint non è specificata, viene usato EntryPoint definito per l'app.	No
RuntimeType	Provider di runtime. In genere usato quando sono presenti framework mescolati in un'app.	Stringa con un valore compreso tra 1 e 255 caratteri in lunghezza che non possono iniziare o terminare con un . oggetto o contenere caratteri: "<:|>?, o .*	No
StartPage	Pagina Web che gestisce il punto di estendibilità.	Stringa con un valore compreso tra 1 e 256 caratteri in lunghezza che non possono contenere questi caratteri: <":|>?, o .*	No
ResourceGroup	Tag facoltativo usato per raggruppare le attivazioni delle estensioni per scopi di gestione delle risorse,ad esempio CPU e memoria. Vedere la sezione Osservazioni in Application@ResourceGroup.	Stringa alfanumerica compresa tra 1 e 255 caratteri di lunghezza. Deve iniziare con una lettera.	No
uap10:TrustLevel	Specifica il livello di attendibilità dell'estensione.	Valore stringa facoltativo. Se specificato, può essere uno dei valori seguenti: appContainer o mediumIL.	No
uap10:RuntimeBehavior	Specifica il comportamento di runtime di un'estensione.	Valore stringa facoltativo. Se specificato, può essere uno dei valori seguenti: windowsApp, packagedClassicApp o win32App.	No
uap10:HostId	Specifica l'ID del runtime host per l'estensione.	Stringa alfanumerica con un valore facoltativo compreso tra 1 e 255 caratteri di lunghezza. Deve iniziare con una lettera.	No
uap10:Parameters	Contiene i parametri della riga di comando da passare all'estensione. Supportato solo per le app desktop.	Stringa con un valore compreso tra 1 e 32767 caratteri in lunghezza con un carattere non di spazi vuoti all'inizio e alla fine.	No
uap11:Id	Identificatore per l'estensione. L'ID deve essere univoco per tutte le estensioni in un pacchetto.	Stringa facoltativa con un valore compreso tra 1 e 255 caratteri in lunghezza con un carattere di spazio non vuoto all'inizio e alla fine.	No
uap11:Sottosistema	Questo attributo viene ereditato dalla sintassi dell'estensione di base e non è applicabile all'estensione com4. Oltre alla convalida sintattica, questo valore viene ignorato.	Stringa facoltativa che può avere uno dei valori seguenti: console o finestre.	No
uap11:SupportsMultipleInstances	Specifica se le istanze devono essere eseguite in processi diversi. Il valore predefinito è false.	Valore booleano facoltativo.	No
uap11:ResourceGroup	Tag che è possibile usare per raggruppare le attivazioni delle estensioni per scopi di gestione delle risorse, ad esempio CPU e memoria. Il valore che è possibile impostare ResourceGroup è free-form e flessibile. Vedere Application@ResourceGroup.	Stringa alfanumerica facoltativa con un valore compreso tra 1 e 255 caratteri di lunghezza. Deve iniziare con una lettera.	No
uap11:CurrentDirectoryPath	Specifica la directory iniziale al momento dell'avvio del processo dell'applicazione.	Stringa facoltativa che non può contenere questi caratteri: <, >, |, ?o *. >	No
uap11:Parameters	Questo attributo viene ereditato dalla sintassi dell'estensione di base e non è applicabile all'estensione com4. Oltre alla convalida sintattica, questo valore viene ignorato.	Stringa facoltativa con un valore compreso tra 1 e 32767 caratteri in lunghezza con un carattere di spazio non vuoto all'inizio e alla fine.	No
desktop7:CompatMode	Specifica se le informazioni dell'estensione vengono registrate con Windows in modi classici (ad esempio, i tipi di registrazione delle app senza pacchetti con COM tramite il Registro di sistema) o in nuovi modi più con ambito. Il valore predefinito è "moderno". CompatMode="classic" richiede la funzionalità Microsoft.classicAppCompat_8wekyb3d8bbwe .	Stringa facoltativa che può avere uno dei valori seguenti: classico o moderno.	No
desktop7:Ambito	Specifica se le registrazioni sono visibili solo ad altre applicazioni in esecuzione come utente che dispone di questo pacchetto registrato (utente) o se sono visibili a tutti gli utenti e ai servizi nel computer (computer). Il valore predefinito è "user". Scope="machine" richiede la funzionalità Microsoft.classicAppCompatElevated_8wekyb3d8bbwe .	Stringa facoltativa che può avere uno dei valori seguenti: computer o utente.	No

Elementi figlio

Elemento figlio	Descrizione
uap3:AppointmentDataProvider	Dichiara un punto di estendibilità dell'app di tipo windows.appointmentDataProvider.
uap3:EmailDataProvider	Dichiara un punto di estendibilità dell'app di tipo windows.emailDataProvider.
uap3:ContactDataProvider	Dichiara un punto di estendibilità dell'app di tipo windows.contactDataProvider.
uap3:AppUriHandler	Dichiara un punto di estendibilità dell'app di tipo windows.appUriHandler.
uap3:AppExtensionHost	Dichiara un punto di estendibilità dell'app di tipo windows.appExtensionHost.
uap3:AppExtension	Dichiara un punto di estendibilità dell'app di tipo windows.appExtension.
uap3:AppService	Dichiara un punto di estendibilità dell'app di tipo windows.appExtension.
uap3:AppExeuctionAlias	Dichiara un punto di estendibilità dell'app di tipo windows.appExecutionAlias.
uap3:Protocol	Dichiara un punto di estendibilità dell'app di tipo windows.protocol.
uap3:FileTypeAssociation	Dichiara un punto di estendibilità dell'app di tipo windows.fileTypeAssociation.

Elementi padre

Elemento padre	Descrizione
Estensioni (tipo: CT_ApplicationExtensions)	Definisce uno o più punti di estendibilità per l'app.

Esempio

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

Requisiti

Elemento	Valore
Namespace	http://schemas.microsoft.com/appx/manifest/uap/windows10/3
uap10	http://schemas.microsoft.com/appx/manifest/uap/windows10/10
Minimum OS Version	Windows 10 versione 1607 (Build 14393)