PackageCatalog.AddResourcePackageAsync Metodo

Definizione

Spazio dei nomi:

Windows.ApplicationModel

Aggiunge un pacchetto di risorse a un pacchetto dell'app esistente.

public:
 virtual IAsyncOperationWithProgress<PackageCatalogAddResourcePackageResult ^, PackageInstallProgress> ^ AddResourcePackageAsync(Platform::String ^ resourcePackageFamilyName, Platform::String ^ resourceID, AddResourcePackageOptions options) = AddResourcePackageAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<PackageCatalogAddResourcePackageResult, PackageInstallProgress> AddResourcePackageAsync(winrt::hstring const& resourcePackageFamilyName, winrt::hstring const& resourceID, AddResourcePackageOptions const& options);

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<PackageCatalogAddResourcePackageResult,PackageInstallProgress> AddResourcePackageAsync(string resourcePackageFamilyName, string resourceID, AddResourcePackageOptions options);

function addResourcePackageAsync(resourcePackageFamilyName, resourceID, options)

Public Function AddResourcePackageAsync (resourcePackageFamilyName As String, resourceID As String, options As AddResourcePackageOptions) As IAsyncOperationWithProgress(Of PackageCatalogAddResourcePackageResult, PackageInstallProgress)

Parametri

resourcePackageFamilyName

String

Platform::String

winrt::hstring

Nome della famiglia di pacchetti che identifica in modo univoco il pacchetto dell'app.

resourceID

String

Platform::String

winrt::hstring

ID risorsa del pacchetto.

options

AddResourcePackageOptions

Opzioni per specificare il comportamento quando si aggiunge un pacchetto di risorse a un'app.

Restituisce

IAsyncOperationWithProgress<PackageCatalogAddResourcePackageResult,PackageInstallProgress>

Report sullo stato di avanzamento dell'aggiunta di un pacchetto di risorse.

Attributi

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)

Esempio

async void btnInstallFrenchProofingTools_Click(object sender, EventArgs e) 
{ 
    var packageCatalog = PackageCatalog.OpenForCurrentPackage(); 
    string familyName = "Microsoft.Word_8wekyb3d8bbwe"; 
    // The resourceId specified in the AppxManifest.xml should be unique within a PackageFamily
    string resourceId = "FR_ProofingTools"; 

    // Install the resource package and start reporting progress on the current 
    // progressBar in the UI
    var installedPackage = await packageCatalog.AddResourcePackageAsync(familyName, resourceId, AddResourcePackageOptions.RestartApplication) 
    .AsTask<PackageCatalogAddResourcePackageResult, PackageInstallProgress>(new Progress<PackageInstallProgress> 
    (progress => { progressBar.CurrentValue = progress.PercentComplete; })); 
}