desktop:Extension

Déclare un point d’extensibilité pour l’application.

Hiérarchie d’éléments

<Paquet>

    <Applications>

         <\Application>

              <\Extensions>

                   <\Desktop:Extension>

Syntaxe

<desktop:Extension
  Category = 'A string value that can be one of the following values: "windows.fullTrustProcess", "windows.startupTask", "windows.toastNotificationActivation", or "windows.searchProtocolHandler".'
  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 *.'
  ResourceGroup =  'An optional alphanumeric string with a value between 1 and 255 characters in length. Must begin with a letter.'
  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 optional alphanumeric string with a value between 1 and 255 characters in length. Must begin with an alphabetic character.'
  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.'
  previewappcompat:CompatMode = 'An optional string that can have one of the following values: "classic" or "modern".'
  previewappcompat:Scope = 'An optional string that can be one of the following values: "user" or "machine".'
  uap11:Id = 'An optional string with a value between 1 and 256 characters in length.'
  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 with a value between 1 and 256 characters in length 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 = 'A string that can have one of the following values: "classic" or "modern".'
  desktop7:Scope = 'A string that can have one of the following values: "machine" or "user".' >

  <!-- Child elements -->
  desktop:FullTrustProcess?
  desktop:StartupTask?
  desktop:ToastNotificationActivation?
  desktop:SearchProtocolHandler?

</desktop:Extension>

Clé :

? facultatif (zéro ou un)

Attributs et éléments

Attributs

Attribut Description Type de données Obligatoire Valeur par défaut
Catégorie Catégorie de l’extension. Valeur de chaîne qui peut être l’une des valeurs suivantes : windows.fullTrustProcess, windows.startupTask, windows.toastNotificationActivation ou windows.searchProtocolHandler. Oui
Exécutable Exécutable de lancement par défaut. Chaîne facultative avec une valeur comprise entre 1 et 256 caractères qui doit se terminer par .exe et ne peut pas contenir ces caractères : <, >, :", |, , ?ou *. Il spécifie l’exécutable par défaut de l’extension. S’il n’est pas spécifié, l’exécutable défini pour l’application est utilisé. Si elle est spécifiée, la propriété EntryPoint est également utilisée. Si cette propriété EntryPoint n’est pas spécifiée, l’élément EntryPoint défini pour l’application est utilisé. Non
EntryPoint ID de classe activable. Chaîne facultative avec une valeur comprise entre 1 et 256 caractères, représentant la tâche qui gère l’extension. Il s’agit généralement du nom complet de l’espace de noms d’un type Windows Runtime. Si EntryPoint n’est pas spécifié, l’élément EntryPoint défini pour l’application est utilisé à la place. Non
RuntimeType Fournisseur d’exécution. Cet attribut est généralement utilisé quand il existe des frameworks mixtes dans une application. Chaîne facultative avec une valeur comprise entre 1 et 255 caractères qui ne peut pas commencer ou se terminer par un point ou contenir les caractères suivants : <, >, ":, /, \, |, , ?, ou *. Non
StartPage La page web qui gère le point d’extensibilité. Chaîne facultative avec une valeur comprise entre 1 et 256 caractères qui ne peut pas contenir ces caractères : <, >, :", |, , ?, ou *. Non
uap10:TrustLevel Spécifie le niveau de confiance de l’extension. Chaîne facultative qui peut avoir l’une des valeurs suivantes : appContainer ou mediumIL. Non
uap10:RuntimeBehavior Spécifie le comportement au moment de l’exécution de l’extension. Chaîne facultative qui peut avoir l’une des valeurs suivantes : windowsApp, packagedClassicApp ou win32App. Non
uap10:HostId Spécifie l’ID d’application de l’application hôte pour l’extension. Chaîne alphanumérique facultative avec une valeur comprise entre 1 et 255 caractères. Doit commencer par un caractère alphabétique. Non
uap10:Parameters Contient les paramètres de ligne de commande à passer à l’extension. Pris en charge uniquement pour les applications de bureau qui ont une identité de package. Chaîne facultative dont la valeur est comprise entre 1 et 32767 caractères, avec un caractère sans espace blanc au début et à la fin. Non
uap11:Id Identificateur de l’extension. Chaîne facultative avec une valeur comprise entre 1 et 255 caractères avec un caractère non-espace blanc au début et à la fin. Non
uap11:Sous-système Cet attribut est hérité de la syntaxe d’extension de base et n’est pas applicable à l’extension com4. Outre la validation syntaxique, cette valeur est ignorée. Chaîne facultative qui peut avoir l’une des valeurs suivantes : console ou windows. Non
uap11:SupportsMultipleInstances Spécifie si les instances doivent s’exécuter dans un objet et un processus de travail différents. La valeur par défaut est false. Valeur booléenne facultative. Non
uap11:ResourceGroup Balise que vous pouvez utiliser pour regrouper les activations d’extensions à des fins de gestion des ressources (par exemple, processeur et mémoire). La valeur que vous pouvez définir ResourceGroup est de forme libre et flexible. Voir Application@ResourceGroup. Chaîne alphanumérique facultative avec une valeur comprise entre 1 et 255 caractères. Doit commencer par une lettre. Non
uap11:CurrentDirectoryPath Spécifie le répertoire initial lorsque le processus d’application est lancé. Chaîne facultative qui ne peut pas contenir ces caractères : <, >, |, ?ou *. > Non
uap11:Parameters Cet attribut est hérité de la syntaxe d’extension de base et n’est pas applicable à l’extension com4. Outre la validation syntaxique, cette valeur est ignorée. Chaîne facultative dont la valeur est comprise entre 1 et 32767 caractères, avec un caractère sans espace blanc au début et à la fin. Non
desktop7:CompatMode Spécifie si les inscriptions dans cette extension sont uniquement visibles par d’autres applications via l’activation COM et d’autres API COM/OLE (modernes), ou si elles doivent également être écrites dans le Registre au format classique (classique). La valeur par défaut est « modern ». Pour plus d'informations, consultez la section Notes. Chaîne facultative le peut avoir l’une des valeurs suivantes : classique ou moderne. Non
desktop7:Scope Spécifie si les inscriptions sont visibles uniquement par d’autres applications s’exécutant en tant qu’utilisateur ayant inscrit ce package (utilisateur), ou si elles sont visibles par tous les utilisateurs et services sur l’ordinateur (machine). La valeur par défaut est « user ». Pour plus d'informations, consultez la section Notes. Chaîne facultative qui peut avoir l’une des valeurs suivantes : machine ou utilisateur. Non

Éléments enfants

Élément enfant Description
FullTrustProcess Représente un processus de bureau qui s’exécute en confiance totale.
StartupTask Représente un processus de bureau qui s’exécute au démarrage de l’application.
ToastNotificationActivation Permet de recevoir une notification toast dans l’application.
SearchProtocolHandler Représente un processus de bureau gère le protocole de recherche de l’application.

Éléments parents

Élément parent Description
Extensions Déclare un point d’extensibilité pour le package.

Notes

L’utilisation de la sémantique de syntaxe de bureau suivante a des exigences de capacité :

  • CompatMode="classic » nécessite Microsoft.classicAppCompat_8wekyb3d8bbwe.
  • Scope="machine » nécessite Microsoft.classicAppCompatElevated_8wekyb3d8bbwe.

Spécifications

Élément Valeur
Espace de noms http://schemas.microsoft.com/appx/manifest/foundation/windows10
uap10 http://schemas.microsoft.com/appx/manifest/uap/windows10/10