uap4:Extension

Descrizione

Dichiara un punto di estendibilità per l'app.

Gerarchia degli elementi

<Pacchetto>
<Applicazioni>
<Applicazione>
<Estensioni>
<uap4:Extension>

Sintassi

<uap4:Extension Category       = "windows.sharedFonts" | "windows.userDataTaskDataProvider" | "windows.mediaCodec" | "windows.contactPanel" | "windows.loopbackAccessRules" | "windows.devicePortalProvider" | "windows.printWorkflowBackgroundTask" | "windows.printWorkflowForegroundTask"
                   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 -->
  ( uap4:SharedFonts
  | uap4:UserDataTaskDataProvider
  | uap4:MediaCodec 
  | uap4:ContactPanel
  | uap4:LoopbackAccessRules
  | uap4:DevicePortalProvider )?

</uap4:Extension>

Chiave

? facoltativo (zero o uno)

Attributi

Attributo Descrizione Tipo di dati Richiesto
Category Categoria dell'estensione. I tipi validi sono:
  • windows.sharedFonts
  • windows.userDataTaskDataProvider
  • windows.mediaCodec
  • windows.contactPanel
  • windows.loopbackAccessRules
  • windows.devicePortalProvider
  • windows.printWorkflowBackgroundTask
  • windows.printWorkflowForegroundTask
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
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
RuntimeType 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
uap10:TrustLevel Specifica il livello di attendibilità dell'estensione. Valore stringa. Può essere uno dei seguenti: "appContainer", "mediumIL". No
uap10:RuntimeBehavior Specifica il comportamento in fase di esecuzione dell'estensione. Valore stringa. Può essere uno dei seguenti: "windowsApp", "packagedClassicApp", "win32App". No
uap10:HostId Specifica l'ID app dell'app host per l'estensione. Stringa alfanumerica di lunghezza compresa tra 1 e 255 caratteri. Deve iniziare con un carattere alfabetico. No
uap10:Parameters Contiene i parametri della riga di comando da passare all'estensione. Supportato solo per le app desktop con identità del pacchetto. Stringa di lunghezza compresa tra 1 e 32767 caratteri con un carattere diverso da uno spazio vuoto all'inizio e alla fine. No

Elementi figlio

Elemento figlio Descrizione
Elementi di carattere condivisi Contiene i percorsi dei tipi di carattere condivisi da usare con l'app.
UserDataTaskDataProvider Consente a un'app di diventare un DataProvider per un'attività.
Mediacodec Definisce un'estensione che consente a un'app di installare codec multimediali dal Microsoft Store.
ContactPanel Abilita il pannello dei contatti in un Windows app.
LoopbackAccessRules Contiene regole per un filtro di loopback che consente la comunicazione tra un'app e un servizio.
DevicePortalProvider Definisce un provider Portale di dispositivi per la distribuzione.

Commenti

windows.printWorkflowBackgroundTask e windows.printWorkflowForegroundTask sono dichiarazioni di estensione vuote che forniscono supporto per gli scenari di stampa. Il punto di ingresso dell'attività in background verrà inizialmente chiamato dal sistema di stampa per avviare la gestione dei dati di stampa e l'attività in primo piano verrà attivata quando si richiedono altre informazioni all'utente. Il punto di ingresso in background deve essere una classe che implementa IBackgroundTask.

Requisiti

Valore
Namespace http://schemas.microsoft.com/appx/manifest/uap/windows10/4

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