PackageManager.AddPackageByUriAsync(Uri, AddPackageOptions) Méthode

Définition

Ajoute un package (le package principal) et tous les packages de dépendances supplémentaires, pour l’utilisateur actuel, à l’aide des options de déploiement spécifiées.

public:
 virtual IAsyncOperationWithProgress<DeploymentResult ^, DeploymentProgress> ^ AddPackageByUriAsync(Uri ^ packageUri, AddPackageOptions ^ options) = AddPackageByUriAsync;
/// [Windows.Foundation.Metadata.Overload("AddPackageByUriAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<DeploymentResult, DeploymentProgress> AddPackageByUriAsync(Uri const& packageUri, AddPackageOptions const& options);
[Windows.Foundation.Metadata.Overload("AddPackageByUriAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<DeploymentResult,DeploymentProgress> AddPackageByUriAsync(System.Uri packageUri, AddPackageOptions options);
function addPackageByUriAsync(packageUri, options)
Public Function AddPackageByUriAsync (packageUri As Uri, options As AddPackageOptions) As IAsyncOperationWithProgress(Of DeploymentResult, DeploymentProgress)

Paramètres

packageUri
Uri Uri

URI du package à ajouter. L’URI peut utiliser le schéma d’URI de fichier (file://) pour les chemins d’accès de fichiers locaux et les chemins de réseau local. Les protocoles HTTP et HTTPS sont également pris en charge. À compter de la build Windows 22556, l’URI peut pointer vers un package ou un fichier du programme d’installation d’application.

options
AddPackageOptions

Options de déploiement de package pour l’opération.

Retours

État de la demande de déploiement. DeploymentResult contient la valeur finale retournée de l’opération de déploiement, une fois celle-ci terminée. DeploymentProgress peut être utilisé pour obtenir le pourcentage d’achèvement sur l’ensemble de l’opération de déploiement.

Attributs

Configuration requise pour Windows

Famille d’appareils
Windows 10, version 2004 (introduit dans 10.0.19041.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v10.0)

Remarques

Cette méthode simplifie les surcharges AddPackageAsync existantes en consolidant toutes les options de déploiement en un seul paramètre. Cette méthode prend également en charge les fonctionnalités suivantes non disponibles avec les surcharges AddPackageAsync :

  • Vous pouvez utiliser la propriété ExternalLocationURI du paramètre options pour spécifier l’URI d’un emplacement de disque externe en dehors du package MSIX où le manifeste de package peut référencer le contenu de l’application. Pour plus d’informations sur ce scénario et un exemple de code associé, consultez Accorder une identité de package en empaquetant avec un emplacement externe.

  • Vous pouvez utiliser la propriété AllowUnsigned du paramètre options pour autoriser les informations d’activation d’un exécutable dans un package non signé. Pour plus d’informations sur ce scénario et un exemple de code associé, consultez Applications hébergées.

S’applique à

Voir aussi