Estensione (tipo: CT_ApplicationExtension)
Dichiara un punto di estendibilità per l'app.
Gerarchia degli elementi
<Estensione>
Sintassi
<Extension Category = "windows.fileTypeAssociation" | "windows.protocol" | "windows.autoPlayContent" | "windows.autoPlayDevice" | "windows.shareTarget" | ...
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 *. >
<!-- Child elements -->
( FileTypeAssociation
| Protocol
| AutoPlayContent
| AutoPlayDevice
| ShareTarget
| FileOpenPicker
| FileSavePicker
| BackgroundTasks
)?
</Extension>
Chiave
? facoltativo (zero o uno)
Attributi ed elementi
Attributi
| Attributo | Descrizione | Tipo di dati | Obbligatoria | Valore predefinito |
|---|---|---|---|---|
| Categoria | Tipo di punto di estendibilità dell'app. |
Questo attributo può avere uno dei valori seguenti:
|
Sì | |
| EntryPoint | ID della classe attivabile. |
Stringa di lunghezza compresa tra 1 e 256 caratteri, che rappresenta l'attività che gestisce l'estensione. Si tratta in genere il nome completo dello spazio dei nomi di tipo Windows Runtime. Se EntryPoint non viene specificato, viene usato l'oggetto EntryPoint definito per l'app. | No | |
| File eseguibile | Eseguibile di avvio predefinito. |
Stringa di lunghezza compresa tra 1 e 256 caratteri che deve terminare con ".exe" e 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 utilizzata anche la proprietà EntryPoint. Se la proprietà EntryPoint non è specificata, viene usato l'oggetto EntryPoint definito per l'app. | No | |
| Tipo di runtime | Provider di runtime. Questo attributo viene usato in genere quando sono presenti framework misti in un'app. |
Stringa di lunghezza compresa tra 1 e 255 caratteri che non può iniziare o terminare con un punto o contenere questi caratteri: <, >, :, ", /, \, |, ?, o *. | No | |
| StartPage | Pagina Web che gestisce il punto di estendibilità. |
Stringa di lunghezza compresa tra 1 e 256 caratteri che non può contenere questi caratteri: <, >, :, ", |, ? o *. | No |
Elementi figlio
| Elemento figlio | Descrizione |
|---|---|
| AutoPlayContent | Dichiara un punto di estendibilità dell'app di tipo windows.autoPlayContent. L'app fornisce le azioni del contenuto AutoPlay specificate. |
| AutoPlayDevice | Dichiara un punto di estendibilità dell'app di tipo windows.autoPlayDevice. L'app fornisce le azioni del dispositivo AutoPlay specificate. |
| BackgroundTasks | Definisce un punto di estendibilità dell'app di tipo windows.backgroundTasks. Le attività in background vengono eseguite in un host in background dedicato. ciò significa che non è disponibile un'interfaccia utente. |
| FileOpenPicker | Dichiara un punto di estendibilità dell'app di tipo windows.fileOpenPicker. L'app consente all'utente di scegliere e aprire i tipi di file specificati. |
| FileSavePicker | Dichiara un punto di estendibilità dell'app di tipo windows.fileSavePicker. L'app consente all'utente di scegliere il nome file, l'estensione e il percorso di archiviazione per i tipi di file specificati. |
| FileTypeAssociation | Dichiara un punto di estendibilità dell'app di tipo windows.fileTypeAssociation. Un'associazione del tipo di file indica che l'app è registrata per gestire i file dei tipi specificati. |
| Protocollo | Dichiara un punto di estendibilità dell'app di tipo windows.protocol. Un'associazione URI indica che l'app è registrata per gestire gli URI con lo schema specificato. |
| ShareTarget | Dichiara un punto di estensione dell'app di tipo windows.shareTarget. L'app può condividere i tipi di file specificati. |
Elementi padre
Questo elemento più esterno (documento) potrebbe non essere contenuto da altri elementi.
Elementi correlati
Gli elementi seguenti hanno lo stesso nome di questo elemento, ma il contenuto o gli attributi sono diversi:
Commenti
Questi punti di estendibilità possono essere dichiarati una sola volta per ogni app:
- windows.accountPictureProvider
- windows.cachedFileUpdater
- windows.cameraSettings
- windows.contactPicker
- windows.fileOpenPicker
- windows.fileSavePicker
- windows.printTaskSettings
- windows.search
- Windows.shareTarget
**Nota sulle regole semantiche per le estensioni: **Per qualsiasi elemento Extension, nell'API manifesto vengono applicate le regole semantiche seguenti:
Se /Application/@StartPage specificato, si tratta di un'app Windows usando JavaScript e l'estensione dell'app :
- Può essere vuoto
- Può specificare solo StartPage
- Può specificare sia Executable che EntryPoint (runtimeType facoltativo consentito), a meno che non si tratta di un'estensione BackgroundTask, nel qual caso è possibile omettere executable e impostare per impostazione predefinita l'eseguibile BackgroundTaskHost.exe.
Se /Application/@StartPage non è specificato, si tratta di un'app UWP che usa C# o VB e XAML e l'estensione dell'app :
- Può essere vuoto
- Può specificare solo StartPage
- Deve specificare EntryPoint se si specifica Executable o RuntimeType.
Vedi anche
ConcettiAppcontracts and extensions (Concetti: contratti ed estensioni dell'app)
Requisiti
| Valore | |
|---|---|
| Namespace | http://schemas.microsoft.com/appx/2010/manifest |