PackageManager.RequestAddPackageAsync Metodo

Riferimento

Definizione

Spazio dei nomi:: Windows.Management.Deployment

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Overload

RequestAddPackageAsync(Uri, IIterable<Uri>, DeploymentOptions, PackageVolume, IIterable<String>, IIterable<Uri>, IIterable<Uri>)	Richiede un controllo SmartScreen e la verifica dell'utente prima di installare i pacchetti dell'app. Questo metodo fornisce un overload packageUrisToInstall per specificare i pacchetti esterni da gestire e registrare.
RequestAddPackageAsync(Uri, IIterable<Uri>, DeploymentOptions, PackageVolume, IIterable<String>, IIterable<Uri>)	Richiede un controllo SmartScreen e la verifica dell'utente prima di installare i pacchetti dell'app.

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

Modifica

Richiede un controllo SmartScreen e la verifica dell'utente prima di installare i pacchetti dell'app. Questo metodo fornisce un overload packageUrisToInstall per specificare i pacchetti esterni da gestire e registrare.

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)

Parametri

packageUri: Uri Uri

URI del pacchetto da aggiungere. L'URI deve seguire lo schema URI del file (file://), perché gli unici schemi URI supportati sono percorsi di file locali e percorsi di rete locali.

dependencyPackageUris: IIterable<Uri>

IEnumerable<Uri>

URI dei pacchetti di dipendenza da aggiungere. Se non sono presenti pacchetti di dipendenza o se i pacchetti di dipendenza sono già registrati, questo parametro può essere Null.

deploymentOptions: DeploymentOptions

Valore di enumerazione valido dell'enumerazione DeploymentOptions .

targetVolume: PackageVolume

Volume in cui è installato il pacchetto.

optionalPackageFamilyNames: IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

Stringhe che specificano i nomi facoltativi della famiglia di pacchetti del bundle principale da gestire e registrare.

relatedPackageUris: IIterable<Uri>

IEnumerable<Uri>

URI di pacchetti aggiuntivi nel bundle principale da gestire e registrare.

packageUrisToInstall: IIterable<Uri>

IEnumerable<Uri>

Elenco di altri URI del pacchetto da preparare e registrare. Può contenere percorsi per i pacchetti esterni da installare.

Restituisce

IAsyncOperationWithProgress<DeploymentResult,DeploymentProgress>

Stato e risultato dell'aggiunta del pacchetto dell'app.

Attributi: OverloadAttribute RemoteAsyncAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10, version 1803 (è stato introdotto in 10.0.17134.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v6.0)

Vedi anche

Pacchetto

Si applica a

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

Modifica

Richiede un controllo SmartScreen e la verifica dell'utente prima di installare i pacchetti dell'app.

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)

Parametri

packageUri: Uri Uri

URI del pacchetto da aggiungere. L'URI deve seguire lo schema URI del file (file://), perché gli unici schemi URI supportati sono percorsi di file locali e percorsi di rete locali.

dependencyPackageUris: IIterable<Uri>

IEnumerable<Uri>

URI dei pacchetti di dipendenza da aggiungere. Se non sono presenti pacchetti di dipendenza o se i pacchetti di dipendenza sono già registrati, questo parametro può essere Null.

deploymentOptions: DeploymentOptions

Valore di enumerazione valido dell'enumerazione DeploymentOptions .

targetVolume: PackageVolume

Volume in cui è installato il pacchetto.

optionalPackageFamilyNames: IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

Stringhe che specificano i nomi facoltativi della famiglia di pacchetti del bundle principale da gestire e registrare.

relatedPackageUris: IIterable<Uri>

IEnumerable<Uri>

URI di pacchetti aggiuntivi nel bundle principale da gestire e registrare.

Restituisce

IAsyncOperationWithProgress<DeploymentResult,DeploymentProgress>

Lo stato di avanzamento e il risultato della distribuzione del pacchetto dell'app.

Attributi: RemoteAsyncAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 Fall Creators Update (è stato introdotto in 10.0.16299.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v5.0)

Esempio

L'esempio illustra come usare RequestAddPackageAsync in un'app UWP associandolo a un gestore di clic del pulsante. Verrà richiamata la finestra dell'interfaccia utente della richiesta 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.
        }
    }
}

Vedi anche

Pacchetto

Si applica a

Condividi tramite

PackageManager.RequestAddPackageAsync Metodo

Definizione

Overload

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

Parametri

Restituisce

Requisiti Windows

Vedi anche

Si applica a

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

Parametri

Restituisce

Requisiti Windows

Esempio

Vedi anche

Si applica a

Commenti e suggerimenti

Risorse aggiuntive