desktop10:Extension (in Package/Extensions)

Dichiara un punto di estendibilità per l'app.

Gerarchia degli elementi

<Pacchetto>

    <Estensioni>

         <desktop10:Extension>

Sintassi

<desktop10:Extension
  Category = 'A string that can be one of the following values: "windows.Folder", "windows.DataShortcuts", or "windows.CustomDesktopEventLog".'
  Executable = 'An optional string with a value 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 isnt specified, the EntryPoint defined for the app is used.'
  EntryPoint = 'An optional string with a value 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 = 'An optional string with a value between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, ", /, \, |, ?, or *.'
  StartPage = 'An optional string with a value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
  uap10:TrustLevel = 'An optional string that can have one of the following values: "appContainer" or "mediumIL".'
  uap10:RuntimeBehavior = 'An optional string that can have one of the following values: "windowsApp", "packagedClassicApp", or "win32App".'
  uap10:HostId = 'An alphanumeric string with a value between 1 and 255 characters in length. Must begin with a letter.'
  uap10:Parameters = 'An optional string with a 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 -->
  desktop10:Folder
  desktop10:DataShortcuts
  desktop10:CustomDesktopEventLog

</desktop10:Extension>

Attributi ed elementi

Attributi

Attributo Descrizione Tipo di dati Obbligatoria Valore predefinito
Categoria Categoria dell'estensione. Stringa che può avere uno dei valori seguenti: windows. Cartella, finestre. DataShortcuts o finestre. CustomDesktopEventLog.
File eseguibile Eseguibile di avvio predefinito. Stringa facoltativa con un valore compreso tra 1 e 256 caratteri che deve terminare con .exe e non può contenere questi caratteri: <, >, :, ", |, ?o *. Specifica l'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 viene specificata, viene utilizzato il EntryPoint definito per l'app. No
EntryPoint ID classe attivabile. Stringa facoltativa con un valore compreso 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 invece usato 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 facoltativa con un valore compreso 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 facoltativa con un valore compreso tra 1 e 256 caratteri che non può contenere questi caratteri: <, , >:, "|, ?, o *. No
uap10:TrustLevel Specifica il livello di attendibilità dell'estensione. Stringa facoltativa che può avere uno dei valori seguenti: appContainer o mediumIL. No
uap10:RuntimeBehavior Specifica il comportamento di runtime dell'estensione. Stringa facoltativa che può avere uno dei valori seguenti: windowsApp, packagedClassicApp o win32App. No
uap10:HostId Specifica l'ID app dell'app host per l'estensione. Stringa alfanumerica con un valore compreso tra 1 e 255 caratteri. 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 con identità del pacchetto. Stringa facoltativa con un valore compreso tra 1 e 32767 caratteri con un carattere non di spazio vuoto all'inizio e alla fine. No
uap11:Id Identificatore dell'estensione. Stringa facoltativa con un valore compreso tra 1 e 255 caratteri con un carattere non vuoto all'inizio e alla fine. No
uap11:Subsystem 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 un oggetto e un processo di processo 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 è in formato libero e flessibile. Vedere Application@ResourceGroup. Stringa alfanumerica facoltativa con un valore compreso tra 1 e 255 caratteri. Deve iniziare con una lettera. No
uap11:CurrentDirectoryPath 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 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 con un carattere non di spazio vuoto all'inizio e alla fine. No
desktop7:CompatMode Specifica se le registrazioni in questa estensione sono visibili solo ad altre applicazioni tramite l'attivazione COM e altre API COM/OLE (moderne) o se devono essere scritte anche nel Registro di sistema nel formato classico (classico). Il valore predefinito è "modern". Per altre informazioni, vedere la sezione Osservazioni. Una stringa facoltativa può avere uno dei valori seguenti: classico o moderno. No
desktop7:Scope 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 i servizi nel computer (computer). Il valore predefinito è "user". Per altre informazioni, vedere la sezione Osservazioni. Stringa facoltativa che può avere uno dei valori seguenti: computer o utente. No

Elementi figlio

Elemento figlio Descrizione
desktop10:Folder Definisce una cartella in cui tenere premuti i collegamenti, con dettagli localizzati.
desktop10:DataShortcuts Specifica un elenco di collegamenti non eseguibili.
desktop10:CustomDesktopEventLog Definisce un registro eventi personalizzato.

Elementi padre

Elemento padre Descrizione
Estensioni (in Pacchetto/applicazione) Definisce uno o più punti di estendibilità per l'applicazione.

Requisiti

Elemento valore
Spazio dei nomi http://schemas.microsoft.com/appx/manifest/desktop/windows10/10
uap10 http://schemas.microsoft.com/appx/manifest/uap/windows10/10