Condividi tramite

rescap:Extension

  • Articolo

Dichiara un punto di estendibilità per l'app.

Gerarchia degli elementi

<Pacchetto>

    <Applicazioni>

         <Applicazione>

              <Estensioni>

                   <rescap:Extension>

Sintassi

<rescap:Extension
  Category = 'A string that can have one of the following values: "windows.settingsApp".'
  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 -->
  rescap:PrimaryInteropAssemblies?
  rescap:ClassicAppCompatKeys? 

</rescap: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. Può essere uno dei valori seguenti: windows.settingsApp. Sì
EntryPoint ID classe attivabile. Stringa con un valore compreso tra 1 e 256 caratteri. Rappresenta l'attività che gestisce l'estensione (in genere 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, 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 utilizzata anche la proprietà EntryPoint. Se la proprietà EntryPoint non viene specificata, viene utilizzato il EntryPoint definito per l'app. No
RuntimeType Provider di runtime. In genere viene usato quando sono presenti framework mescolati in un'app. Stringa con un valore compreso tra 1 e 255 caratteri che non può 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 che non può contenere questi caratteri: <, >, :, "|, ?, o *. No
ResourceGroup Tag facoltativo usato per raggruppare le attivazioni dell'estensione 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. 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. 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 di lunghezza con un carattere non di spazio vuoto all'inizio e alla fine. No
uap11:Id Identificatore dell'estensione. L'ID deve essere univoco per tutte le estensioni di un pacchetto. 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 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 è 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 Specifica la directory iniziale all'avvio del processo dell'applicazione. Questo attributo supporta le macro. Per altre informazioni, vedi Macro nello schema del manifesto del pacchetto. 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. Questo attributo supporta le macro. Per altre informazioni, vedere Macro nello schema del manifesto del pacchetto. 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
SettingsApp Registra i collegamenti profondi e le informazioni di ricerca per le app visualizzate nell'app Impostazioni di Windows.

Elementi padre

Elemento padre Descrizione
Estensioni Definisce uno o più punti di estendibilità per l'app.

Requisiti

Elemento valore
rescap http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities/4
uap10 http://schemas.microsoft.com/appx/manifest/uap/windows10/10
uap11 http://schemas.microsoft.com/appx/manifest/uap/windows10/11
Minimum OS Version Windows 10 versione 1511 (Build 10586)