PackageManager.RequestAddPackageAsync Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Surcharges
| RequestAddPackageAsync(Uri, IIterable<Uri>, DeploymentOptions, PackageVolume, IIterable<String>, IIterable<Uri>, IIterable<Uri>) |
Demande une vérification case activée et utilisateur SmartScreen avant d’installer le ou les packages d’application. Cette méthode fournit une surcharge packageUrisToInstall pour spécifier les packages externes à mettre en lots et à inscrire. |
| RequestAddPackageAsync(Uri, IIterable<Uri>, DeploymentOptions, PackageVolume, IIterable<String>, IIterable<Uri>) |
Demande une vérification case activée et utilisateur SmartScreen avant d’installer le ou les packages d’application. |
RequestAddPackageAsync(Uri, IIterable<Uri>, DeploymentOptions, PackageVolume, IIterable<String>, IIterable<Uri>, IIterable<Uri>)
Demande une vérification case activée et utilisateur SmartScreen avant d’installer le ou les packages d’application. Cette méthode fournit une surcharge packageUrisToInstall pour spécifier les packages externes à mettre en lots et à inscrire.
public:
virtual IAsyncOperationWithProgress<DeploymentResult ^, DeploymentProgress> ^ RequestAddPackageAsync(Uri ^ packageUri, IIterable<Uri ^> ^ dependencyPackageUris, DeploymentOptions deploymentOptions, PackageVolume ^ targetVolume, IIterable<Platform::String ^> ^ optionalPackageFamilyNames, IIterable<Uri ^> ^ relatedPackageUris, IIterable<Uri ^> ^ packageUrisToInstall) = RequestAddPackageAsync;/// [Windows.Foundation.Metadata.Overload("RequestAddPackageAndRelatedSetAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<DeploymentResult, DeploymentProgress> RequestAddPackageAsync(Uri const& packageUri, IIterable<Uri> const& dependencyPackageUris, DeploymentOptions const& deploymentOptions, PackageVolume const& targetVolume, IIterable<winrt::hstring> const& optionalPackageFamilyNames, IIterable<Uri> const& relatedPackageUris, IIterable<Uri> const& packageUrisToInstall);[Windows.Foundation.Metadata.Overload("RequestAddPackageAndRelatedSetAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<DeploymentResult,DeploymentProgress> RequestAddPackageAsync(System.Uri packageUri, IEnumerable<System.Uri> dependencyPackageUris, DeploymentOptions deploymentOptions, PackageVolume targetVolume, IEnumerable<string> optionalPackageFamilyNames, IEnumerable<System.Uri> relatedPackageUris, IEnumerable<System.Uri> packageUrisToInstall);function requestAddPackageAsync(packageUri, dependencyPackageUris, deploymentOptions, targetVolume, optionalPackageFamilyNames, relatedPackageUris, packageUrisToInstall)Public Function RequestAddPackageAsync (packageUri As Uri, dependencyPackageUris As IEnumerable(Of Uri), deploymentOptions As DeploymentOptions, targetVolume As PackageVolume, optionalPackageFamilyNames As IEnumerable(Of String), relatedPackageUris As IEnumerable(Of Uri), packageUrisToInstall As IEnumerable(Of Uri)) As IAsyncOperationWithProgress(Of DeploymentResult, DeploymentProgress)Paramètres
URI du package à ajouter. L’URI doit suivre le schéma d’URI de fichier (file://), car les seuls schémas d’URI pris en charge sont les chemins d’accès aux fichiers locaux et les chemins de réseau local.
- dependencyPackageUris
URI des packages de dépendances à ajouter. S’il n’existe aucun package de dépendances ou si les packages de dépendances sont déjà inscrits, ce paramètre peut être null.
- deploymentOptions
- DeploymentOptions
Valeur d’énumération valide de l’énumération DeploymentOptions .
- targetVolume
- PackageVolume
Volume sur lequel le package est installé.
Chaînes qui spécifient les noms de famille de packages facultatifs du bundle main à indexer et à inscrire.
- relatedPackageUris
URI des packages supplémentaires dans le bundle main qui doivent être intermédiaires et enregistrés.
- packageUrisToInstall
Liste d’autres URI de package à mettre en phase et à inscrire. Cela peut contenir des chemins d’accès aux packages externes à installer.
Retours
Progression et résultat de l’ajout du package d’application.
- Attributs
Configuration requise pour Windows
| Famille d’appareils |
Windows 10, version 1803 (introduit dans 10.0.17134.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduit dans v6.0)
|
Voir aussi
S’applique à
RequestAddPackageAsync(Uri, IIterable<Uri>, DeploymentOptions, PackageVolume, IIterable<String>, IIterable<Uri>)
Demande une vérification case activée et utilisateur SmartScreen avant d’installer le ou les packages d’application.
public:
virtual IAsyncOperationWithProgress<DeploymentResult ^, DeploymentProgress> ^ RequestAddPackageAsync(Uri ^ packageUri, IIterable<Uri ^> ^ dependencyPackageUris, DeploymentOptions deploymentOptions, PackageVolume ^ targetVolume, IIterable<Platform::String ^> ^ optionalPackageFamilyNames, IIterable<Uri ^> ^ relatedPackageUris) = RequestAddPackageAsync;/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<DeploymentResult, DeploymentProgress> RequestAddPackageAsync(Uri const& packageUri, IIterable<Uri> const& dependencyPackageUris, DeploymentOptions const& deploymentOptions, PackageVolume const& targetVolume, IIterable<winrt::hstring> const& optionalPackageFamilyNames, IIterable<Uri> const& relatedPackageUris);[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<DeploymentResult,DeploymentProgress> RequestAddPackageAsync(System.Uri packageUri, IEnumerable<System.Uri> dependencyPackageUris, DeploymentOptions deploymentOptions, PackageVolume targetVolume, IEnumerable<string> optionalPackageFamilyNames, IEnumerable<System.Uri> relatedPackageUris);function requestAddPackageAsync(packageUri, dependencyPackageUris, deploymentOptions, targetVolume, optionalPackageFamilyNames, relatedPackageUris)Public Function RequestAddPackageAsync (packageUri As Uri, dependencyPackageUris As IEnumerable(Of Uri), deploymentOptions As DeploymentOptions, targetVolume As PackageVolume, optionalPackageFamilyNames As IEnumerable(Of String), relatedPackageUris As IEnumerable(Of Uri)) As IAsyncOperationWithProgress(Of DeploymentResult, DeploymentProgress)Paramètres
URI du package à ajouter. L’URI doit suivre le schéma d’URI de fichier (file://), car les seuls schémas d’URI pris en charge sont les chemins d’accès aux fichiers locaux et les chemins de réseau local.
- dependencyPackageUris
URI des packages de dépendances à ajouter. S’il n’existe aucun package de dépendances ou si les packages de dépendances sont déjà inscrits, ce paramètre peut être null.
- deploymentOptions
- DeploymentOptions
Valeur d’énumération valide de l’énumération DeploymentOptions .
- targetVolume
- PackageVolume
Volume sur lequel le package est installé.
Chaînes qui spécifient les noms de famille de packages facultatifs du bundle main à indexer et à inscrire.
- relatedPackageUris
URI des packages supplémentaires dans le bundle main qui doivent être intermédiaires et enregistrés.
Retours
Progression et résultat du déploiement du package d’application.
- Attributs
Configuration requise pour Windows
| Famille d’appareils |
Windows 10 Fall Creators Update (introduit dans 10.0.16299.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduit dans v5.0)
|
Exemples
L’exemple montre comment utiliser RequestAddPackageAsync dans une application UWP en la connectant à un gestionnaire de clic de bouton. Cela appelle la fenêtre d’interface utilisateur de la requête SmartScreen.
public async void OnInstallNowClicked(object sender, RoutedEventArgs args)
{
var packageManager = new PackageManager();
DeploymentOperation result = await packageManager.RequestAddPackageAsync(
this.currentPackageUri,
null /*no dependencies*/,
DeploymentOptions.None,
null /*stage to default package volume*/,
null /*no optional packages*/,
null /*no external packages*/);
if (result.ExtendedErrorCode != null)
{
if (result.ExtendedErrorCode.HResult == 0x80073d01)
{
// SmartScreen blocked the app installation.
}
else
{
// The app installation failed for another reason.
}
}
}