PackageManager.RequestAddPackageAsync Metode

Definisi

Overload

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

Meminta pemeriksaan SmartScreen dan verifikasi pengguna sebelum menginstal Paket aplikasi. Metode ini menyediakan kelebihan beban packageUrisToInstall untuk menentukan paket eksternal yang akan dipentaskan dan didaftarkan.

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

Meminta pemeriksaan SmartScreen dan verifikasi pengguna sebelum menginstal Paket aplikasi.

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

Meminta pemeriksaan SmartScreen dan verifikasi pengguna sebelum menginstal Paket aplikasi. Metode ini menyediakan kelebihan beban packageUrisToInstall untuk menentukan paket eksternal yang akan dipentaskan dan didaftarkan.

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)

Parameter

packageUri
Uri Uri

URI paket yang akan ditambahkan. URI harus mengikuti skema URI file (file://) karena satu-satunya skema URI yang didukung adalah jalur file lokal dan jalur jaringan lokal.

dependencyPackageUris

IIterable<Uri>

IEnumerable<Uri>

URI paket dependensi yang akan ditambahkan. Jika tidak ada paket dependensi atau jika paket dependensi sudah terdaftar, parameter ini bisa null.

deploymentOptions
DeploymentOptions

Nilai enumerasi yang valid dari enumerasi DeploymentOptions .

targetVolume
PackageVolume

Volume tempat paket diinstal.

optionalPackageFamilyNames

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

String yang menentukan nama keluarga paket opsional dari bundel utama yang akan ditahapkan dan didaftarkan.

relatedPackageUris

IIterable<Uri>

IEnumerable<Uri>

URI paket tambahan dalam bundel utama yang harus ditahapkan dan didaftarkan.

packageUrisToInstall

IIterable<Uri>

IEnumerable<Uri>

Daftar URI paket lain yang akan ditahapkan dan didaftarkan. Ini dapat berisi jalur ke paket eksternal yang akan diinstal.

Mengembalikan

Kemajuan dan hasil penambahan paket aplikasi.

Atribut

Persyaratan Windows

Rangkaian perangkat
Windows 10, version 1803 (diperkenalkan dalam 10.0.17134.0)
API contract
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v6.0)

Lihat juga

Berlaku untuk

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

Meminta pemeriksaan SmartScreen dan verifikasi pengguna sebelum menginstal Paket aplikasi.

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)

Parameter

packageUri
Uri Uri

URI paket yang akan ditambahkan. URI harus mengikuti skema URI file (file://) karena satu-satunya skema URI yang didukung adalah jalur file lokal dan jalur jaringan lokal.

dependencyPackageUris

IIterable<Uri>

IEnumerable<Uri>

URI paket dependensi yang akan ditambahkan. Jika tidak ada paket dependensi atau jika paket dependensi sudah terdaftar, parameter ini bisa null.

deploymentOptions
DeploymentOptions

Nilai enumerasi yang valid dari enumerasi DeploymentOptions .

targetVolume
PackageVolume

Volume tempat paket diinstal.

optionalPackageFamilyNames

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

String yang menentukan nama keluarga paket opsional dari bundel utama yang akan ditahapkan dan didaftarkan.

relatedPackageUris

IIterable<Uri>

IEnumerable<Uri>

URI paket tambahan dalam bundel utama yang harus ditahapkan dan didaftarkan.

Mengembalikan

Kemajuan dan hasil penyebaran paket aplikasi.

Atribut

Persyaratan Windows

Rangkaian perangkat
Windows 10 Fall Creators Update (diperkenalkan dalam 10.0.16299.0)
API contract
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v5.0)

Contoh

Contoh menunjukkan cara menggunakan RequestAddPackageAsync di aplikasi UWP dengan menghubungkannya ke handler klik tombol. Ini akan memanggil jendela UI permintaan 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.
        }
    }
}

Lihat juga

Berlaku untuk