Estensione (in Application/Extensions) (Windows 10)Extension (in Application/Extensions) (Windows 10)

Dichiara un punto di estendibilità per il pacchetto.Declares an extensibility point for the package.

Gerarchia degli elementiElement hierarchy

<Pacchetto>
<Package>
<Applicazioni>
<Applications>
<Applicazione>
<Application>
<Estensioni>
<Extensions>
<Estensione><Extension>

SintassiSyntax

<Extension Category       = "windows.backgroundTasks" | "windows.preInstalledConfigTask" | "windows.updateTask" | "windows.restrictedLaunch"
           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 -->
  BackgroundTasks?

</Extension>

ChiaveKey

?   facoltativo (zero o uno)?   optional (zero or one)

Attributi ed elementiAttributes and Elements

AttributiAttributes

AttributoAttribute DescrizioneDescription Tipo di datiData type ObbligatoriaRequired Valore predefinitoDefault value
CategoriaCategory

Tipo di punto di estendibilità del pacchetto.The type of package extensibility point.

Questo attributo può avere uno dei valori seguenti:This attribute can have one of the following values:

  • Windows. backgroundTaskswindows.backgroundTasks
  • Windows. preInstalledConfigTaskwindows.preInstalledConfigTask
  • Windows. updateTaskwindows.updateTask
  • Windows. restrictedLaunchwindows.restrictedLaunch
Yes
EntryPointEntryPoint

ID della classe attivabile.The activatable class ID.

Stringa di lunghezza compresa tra 1 e 256 caratteri, che rappresenta l'attività che gestisce l'estensione.A string between 1 and 256 characters in length, representing the task handling the extension. Si tratta in genere il nome completo dello spazio dei nomi di tipo Windows Runtime.This is normally the fully namespace-qualified name of a Windows Runtime type. Se EntryPoint non è specificato, viene usato il EntryPoint definito per l'app.If EntryPoint is not specified, the EntryPoint defined for the app is used instead. NoNo
File eseguibileExecutable

Eseguibile di avvio predefinito.The default launch executable.

Una stringa di lunghezza compresa tra 1 e 256 caratteri che deve terminare con " . exe " e non può contenere i caratteri seguenti: < , > ,:, " , |,? o \*.A string between 1 and 256 characters in length that must end with ".exe" and cannot contain these characters: <, >, :, ", |, ?, or \*. Specifica il file eseguibile predefinito per l'estensione.It specifies the default executable for the extension. Se non specificato, viene usato il file eseguibile definito per l'app.If not specified, the executable defined for the app is used. Se specificato, viene utilizzata anche la proprietà EntryPoint.If specified, the EntryPoint property is also used. Se tale proprietà EntryPoint non è specificata, viene usato il EntryPoint definito per l'app.If that EntryPoint property isn't specified, the EntryPoint defined for the app is used. NoNo
ResourceGroupResourceGroup

Un tag che è possibile usare per raggruppare le attivazioni di estensione per scopi di gestione delle risorse, ad esempio CPU e memoria.A tag that you can use to group extension activations together for resource management purposes (for example, CPU and memory). Il valore che è possibile impostare ResourceGroup è formato libero e flessibile.The value you can set ResourceGroup is free-form and flexible. Vedere Application@ResourceGroup e note.See Application@ResourceGroup and Remarks.

Stringa alfanumerica di lunghezza compresa tra 1 e 255 caratteri.An alphanumeric string between 1 and 255 characters in length. Deve iniziare con un carattere alfabetico.Must begin with an alphabetic character. NoNo
RuntimeTypeRuntimeType

Provider di Runtime.The runtime provider. Questo attributo viene usato in genere in presenza di Framework misti in un'app.This attribute is used typically when there are mixed frameworks in an app.

Una stringa di lunghezza compresa tra 1 e 255 caratteri non può iniziare o terminare con un punto o contenere i caratteri seguenti: < , > ,:, " ,/, \, |,? o \*.A string between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, ", /, \, |, ?, or \*. NoNo
StartPageStartPage

Pagina Web che gestisce il punto di estendibilità.The web page that handles the extensibility point.

Una stringa di lunghezza compresa tra 1 e 256 caratteri che non può contenere i caratteri seguenti: < , > ,:, " , |,? o \*.A string between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or \*. NoNo
uap10: TrustLeveluap10:TrustLevel

Specifica il livello di attendibilità dell'estensione.Specifies the trust level of the extension.

Valore stringa.String value. Può essere uno dei seguenti: "appContainer", "mediumIL".Can be one of the following: "appContainer", "mediumIL". NoNo
uap10:RuntimeBehavioruap10:RuntimeBehavior

Specifica il comportamento in fase di esecuzione dell'estensione.Specifies the run time behavior of the extension.

Valore stringa.String value. Può essere uno dei seguenti: "windowsApp", "packagedClassicApp", "win32App".Can be one of the following: "windowsApp", "packagedClassicApp", "win32App". NoNo
uap10: HostIduap10:HostId

Questo valore specifica l'ID app dell'app host per l'estensione.This value specifies the app ID of the host app for the extension.

Stringa alfanumerica di lunghezza compresa tra 1 e 255 caratteri.An alphanumeric string between 1 and 255 characters in length. Deve iniziare con un carattere alfabetico.Must begin with an alphabetic character. NoNo
uap10: parametriuap10:Parameters

Contiene i parametri della riga di comando da passare all'estensione.Contains command line parameters to pass to the extension. Supportato solo per le applicazioni desktop con identità del pacchetto.Only supported for desktop apps that have package identity.

Una stringa di lunghezza compresa tra 1 e 32767 caratteri con un carattere diverso da uno spazio vuoto all'inizio e alla fine.A string between 1 and 32767 characters in length with a non-whitespace character at its beginning and end. NoNo

 

Elementi figlioChild Elements

Elemento figlioChild Element DescrizioneDescription
BackgroundTasks BackgroundTasks

Definisce un punto di estendibilità dell'app di tipo Windows. backgroundTasks.Defines an app extensibility point of type windows.backgroundTasks. Le attività in background vengono eseguite in un host in background dedicato; ovvero senza un'interfaccia utente.Background tasks run in a dedicated background host; that is, without a UI.

 

Elementi padreParent Elements

Elemento padreParent Element DescrizioneDescription
Estensioni (tipo: CT_ApplicationExtensions) Extensions (type: CT_ApplicationExtensions)

Definisce uno o più punti di estensibilità per l'app.Defines one or more extensibility points for the app.

 

Gli elementi seguenti hanno lo stesso nome di questo elemento, ma il contenuto o gli attributi sono diversi:The following elements have the same name as this one, but different content or attributes:

OsservazioniRemarks

I punti di estensibilità sono un meccanismo mediante il quale un pacchetto può aggiungere funzionalità in un modo definito dal sistema operativo.Extensibility points are a mechanism by which a package can add functionality in a manner defined by the operating system. Un punto di estendibilità è un percorso in cui un'app può registrarsi per eseguire il codice o usare le risorse del pacchetto corrente.An extensibility point is a location where an app can register to execute code or use resources of the current package. Per aggiungere funzionalità per una determinata app, usare l'elemento figlio dell' applicazione dell'elemento Applications .To add functionality for a particular app, use the Application child element of the Applications element.

Il punto di estendibilità di Windows. Certificates non può essere dichiarato più volte in un manifesto.The windows.certificates extensibility point can't be declared multiple times in a manifest.

Nota    Se l'attributo Category è Windows, è necessario specificare l'attributo EntryPoint o Startpage . UpdateTask o Windows. preInstalledConfigTask per le versioni di Windows 10 precedenti a Windows 10, versione 1607.Note  Either the EntryPoint or StartPage attribute is required if the Category attribute is windows.UpdateTask or windows.preInstalledConfigTask for versions of Windows 10 before Windows 10, version 1607. A partire da Windows 10, versione 1607, non è più necessario specificare un valore per EntryPoint o Startpage quando Category è Windows. UpdateTask o Windows. preInstalledConfigTask e l'applicazione hanno come destinazione solo i dispositivi che eseguono Windows 10, versione 1607 o successiva.Starting with Windows 10, version 1607, you no longer need to specify a value for EntryPoint or StartPage when Category is windows.UpdateTask or windows.preInstalledConfigTask and your application targets only devices that run Windows 10, version 1607 or later.

 

Vedere ancheSee also

Concetti di Contratti ed estensioni per le appConcepts App contracts and extensions

RequisitiRequirements

Spazio dei nomiNamespace http://schemas.microsoft.com/appx/manifest/foundation/windows10

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