PackageManager.RequestAddPackageAsync Méthode

Référence

Définition

Espace de noms:: Windows.Management.Deployment

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>)

Modifier

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

packageUri: Uri Uri

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: IIterable<Uri>

IEnumerable<Uri>

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é.

optionalPackageFamilyNames: IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

Chaînes qui spécifient les noms de famille de packages facultatifs du bundle main à indexer et à inscrire.

relatedPackageUris: IIterable<Uri>

IEnumerable<Uri>

URI des packages supplémentaires dans le bundle main qui doivent être intermédiaires et enregistrés.

packageUrisToInstall: IIterable<Uri>

IEnumerable<Uri>

Liste d’autres URI de package à mettre en phase et à inscrire. Cela peut contenir des chemins d’accès aux packages externes à installer.

Retours

IAsyncOperationWithProgress<DeploymentResult,DeploymentProgress>

Progression et résultat de l’ajout du package d’application.

Attributs: OverloadAttribute RemoteAsyncAttribute

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

Package

S’applique à

RequestAddPackageAsync(Uri, IIterable<Uri>, DeploymentOptions, PackageVolume, IIterable<String>, IIterable<Uri>)

Modifier

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

packageUri: Uri Uri

dependencyPackageUris: IIterable<Uri>

IEnumerable<Uri>

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é.

optionalPackageFamilyNames: IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

Chaînes qui spécifient les noms de famille de packages facultatifs du bundle main à indexer et à inscrire.

relatedPackageUris: IIterable<Uri>

IEnumerable<Uri>

URI des packages supplémentaires dans le bundle main qui doivent être intermédiaires et enregistrés.

Retours

IAsyncOperationWithProgress<DeploymentResult,DeploymentProgress>

Progression et résultat du déploiement du package d’application.

Attributs: RemoteAsyncAttribute

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.
        }
    }
}

Voir aussi

Package

S’applique à

Partager via

PackageManager.RequestAddPackageAsync Méthode

Définition

Surcharges

RequestAddPackageAsync(Uri, IIterable<Uri>, DeploymentOptions, PackageVolume, IIterable<String>, IIterable<Uri>, IIterable<Uri>)

Paramètres

Retours

Configuration requise pour Windows

Voir aussi

S’applique à

RequestAddPackageAsync(Uri, IIterable<Uri>, DeploymentOptions, PackageVolume, IIterable<String>, IIterable<Uri>)

Paramètres

Retours

Configuration requise pour Windows

Exemples

Voir aussi

S’applique à

Commentaires

Ressources supplémentaires