PackageManager.StagePackageAsync Method

Definition

Namespace:

Windows.Management.Deployment

Overloads

StagePackageAsync(Uri, IIterable<Uri>)	Stages a Package to the system without registering it.
StagePackageAsync(Uri, IIterable<Uri>, DeploymentOptions)	Stages a Package to the system without registering it.
StagePackageAsync(Uri, IIterable<Uri>, DeploymentOptions, PackageVolume)	Stages a Package to the system without registering it.
StagePackageAsync(Uri, IIterable<Uri>, DeploymentOptions, PackageVolume, IIterable<String>, IIterable<Uri>)	Stages a Package to the system without registering it.
StagePackageAsync(Uri, IIterable<Uri>, DeploymentOptions, PackageVolume, IIterable<String>, IIterable<Uri>, IIterable<Uri>)	Stages a Package to the system without registering it.

StagePackageAsync(Uri, IIterable<Uri>)

Stages a Package to the system without registering it.

public:
 virtual IAsyncOperationWithProgress<DeploymentResult ^, DeploymentProgress> ^ StagePackageAsync(Uri ^ packageUri, IIterable<Uri ^> ^ dependencyPackageUris) = StagePackageAsync;

IAsyncOperationWithProgress<DeploymentResult, DeploymentProgress> StagePackageAsync(Uri const& packageUri, IIterable<Uri> const& dependencyPackageUris);

public IAsyncOperationWithProgress<DeploymentResult,DeploymentProgress> StagePackageAsync(System.Uri packageUri, IEnumerable<System.Uri> dependencyPackageUris);

function stagePackageAsync(packageUri, dependencyPackageUris)

Public Function StagePackageAsync (packageUri As Uri, dependencyPackageUris As IEnumerable(Of Uri)) As IAsyncOperationWithProgress(Of DeploymentResult, DeploymentProgress)

Parameters

packageUri

Uri Uri

The source URI of the main package.

dependencyPackageUris

IIterable<Uri>

IEnumerable<Uri>

The source URIs of the dependency packages. If there are no dependency packages or dependency packages are already staged, this parameter can be null.

Returns

IAsyncOperationWithProgress<DeploymentResult,DeploymentProgress>

The status of the deployment request. The DeploymentResult contains the final returned value of the deployment operation, once it is completed. The DeploymentProgress can be used to obtain the percentage of completion over the entire course of the deployment operation.

Remarks

The stage operation will extract the package payload to disk under %ProgramFiles%\WindowsApps.

See also

• StagePackageAsync(Uri, IIterable<Uri>, DeploymentOptions)
• Package

StagePackageAsync(Uri, IIterable<Uri>, DeploymentOptions)

Stages a Package to the system without registering it.

public:
 virtual IAsyncOperationWithProgress<DeploymentResult ^, DeploymentProgress> ^ StagePackageAsync(Uri ^ packageUri, IIterable<Uri ^> ^ dependencyPackageUris, DeploymentOptions deploymentOptions) = StagePackageAsync;

/// [Windows.Foundation.Metadata.Overload("StagePackageWithOptionsAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<DeploymentResult, DeploymentProgress> StagePackageAsync(Uri const& packageUri, IIterable<Uri> const& dependencyPackageUris, DeploymentOptions const& deploymentOptions);

[Windows.Foundation.Metadata.Overload("StagePackageWithOptionsAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<DeploymentResult,DeploymentProgress> StagePackageAsync(System.Uri packageUri, IEnumerable<System.Uri> dependencyPackageUris, DeploymentOptions deploymentOptions);

function stagePackageAsync(packageUri, dependencyPackageUris, deploymentOptions)

Public Function StagePackageAsync (packageUri As Uri, dependencyPackageUris As IEnumerable(Of Uri), deploymentOptions As DeploymentOptions) As IAsyncOperationWithProgress(Of DeploymentResult, DeploymentProgress)

Parameters

packageUri

Uri Uri

The source URI of the main package.

dependencyPackageUris

IIterable<Uri>

IEnumerable<Uri>

The source URIs of the dependency packages. If there are no dependency packages or dependency packages are already staged, this parameter can be null.

deploymentOptions

DeploymentOptions

A combination of DeploymentOptions-typed values that are combined by using a bitwise OR operation. The resulting value specifies the package deployment options.

Returns

IAsyncOperationWithProgress<DeploymentResult,DeploymentProgress>

The status of the deployment request. The DeploymentResult contains the final returned value of the deployment operation, once it is completed. The DeploymentProgress can be used to obtain the percentage of completion over the entire course of the deployment operation.

Attributes

OverloadAttribute RemoteAsyncAttribute

See also

• StagePackageAsync(Uri, IIterable<Uri>)
• Package

StagePackageAsync(Uri, IIterable<Uri>, DeploymentOptions, PackageVolume)

Stages a Package to the system without registering it.

public:
 virtual IAsyncOperationWithProgress<DeploymentResult ^, DeploymentProgress> ^ StagePackageAsync(Uri ^ packageUri, IIterable<Uri ^> ^ dependencyPackageUris, DeploymentOptions deploymentOptions, PackageVolume ^ targetVolume) = StagePackageAsync;

/// [Windows.Foundation.Metadata.Overload("StagePackageToVolumeAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<DeploymentResult, DeploymentProgress> StagePackageAsync(Uri const& packageUri, IIterable<Uri> const& dependencyPackageUris, DeploymentOptions const& deploymentOptions, PackageVolume const& targetVolume);

[Windows.Foundation.Metadata.Overload("StagePackageToVolumeAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<DeploymentResult,DeploymentProgress> StagePackageAsync(System.Uri packageUri, IEnumerable<System.Uri> dependencyPackageUris, DeploymentOptions deploymentOptions, PackageVolume targetVolume);

function stagePackageAsync(packageUri, dependencyPackageUris, deploymentOptions, targetVolume)

Public Function StagePackageAsync (packageUri As Uri, dependencyPackageUris As IEnumerable(Of Uri), deploymentOptions As DeploymentOptions, targetVolume As PackageVolume) As IAsyncOperationWithProgress(Of DeploymentResult, DeploymentProgress)

Parameters

packageUri

Uri Uri

The source URI of the main package.

dependencyPackageUris

IIterable<Uri>

IEnumerable<Uri>

The source URIs of the dependency packages. If there are no dependency packages or dependency packages are already staged, this parameter can be null.

deploymentOptions

DeploymentOptions

A bitwise combination of enumeration values from the DeploymentOptions enumeration. The resulting value specifies the package deployment options.

targetVolume

PackageVolume

The target volume on which to stage the package.

Returns

IAsyncOperationWithProgress<DeploymentResult,DeploymentProgress>

An object that the caller can observe to track progress and completion for the call. The object implements the IAsyncOperationWithProgress pattern.

Attributes

OverloadAttribute RemoteAsyncAttribute

See also

• StagePackageAsync(Uri, IIterable<Uri>)
• StagePackageAsync(Uri, IIterable<Uri>, DeploymentOptions)
• Package

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

Stages a Package to the system without registering it.

public:
 virtual IAsyncOperationWithProgress<DeploymentResult ^, DeploymentProgress> ^ StagePackageAsync(Uri ^ packageUri, IIterable<Uri ^> ^ dependencyPackageUris, DeploymentOptions deploymentOptions, PackageVolume ^ targetVolume, IIterable<Platform::String ^> ^ optionalPackageFamilyNames, IIterable<Uri ^> ^ externalPackageUris) = StagePackageAsync;

/// [Windows.Foundation.Metadata.DefaultOverload]
/// [Windows.Foundation.Metadata.Overload("StagePackageToVolumeAndOptionalPackagesAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<DeploymentResult, DeploymentProgress> StagePackageAsync(Uri const& packageUri, IIterable<Uri> const& dependencyPackageUris, DeploymentOptions const& deploymentOptions, PackageVolume const& targetVolume, IIterable<winrt::hstring> const& optionalPackageFamilyNames, IIterable<Uri> const& externalPackageUris);

[Windows.Foundation.Metadata.DefaultOverload]
[Windows.Foundation.Metadata.Overload("StagePackageToVolumeAndOptionalPackagesAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<DeploymentResult,DeploymentProgress> StagePackageAsync(System.Uri packageUri, IEnumerable<System.Uri> dependencyPackageUris, DeploymentOptions deploymentOptions, PackageVolume targetVolume, IEnumerable<string> optionalPackageFamilyNames, IEnumerable<System.Uri> externalPackageUris);

function stagePackageAsync(packageUri, dependencyPackageUris, deploymentOptions, targetVolume, optionalPackageFamilyNames, externalPackageUris)

Public Function StagePackageAsync (packageUri As Uri, dependencyPackageUris As IEnumerable(Of Uri), deploymentOptions As DeploymentOptions, targetVolume As PackageVolume, optionalPackageFamilyNames As IEnumerable(Of String), externalPackageUris As IEnumerable(Of Uri)) As IAsyncOperationWithProgress(Of DeploymentResult, DeploymentProgress)

Parameters

packageUri

Uri Uri

The source URI of the main package.

dependencyPackageUris

IIterable<Uri>

IEnumerable<Uri>

The source URIs of the dependency packages. If there are no dependency packages or dependency packages are already staged, this parameter can be null.

deploymentOptions

DeploymentOptions

A bitwise combination of enumeration values from the DeploymentOptions enumeration. The resulting value specifies the package deployment options.

targetVolume

PackageVolume

The target volume on which to stage the package.

optionalPackageFamilyNames

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

Strings that specify the optional package family names from the main bundle to be staged.

externalPackageUris

IIterable<Uri>

IEnumerable<Uri>

The source URIs of other packages in the main bundle to be staged.

Returns

IAsyncOperationWithProgress<DeploymentResult,DeploymentProgress>

An object that the caller can observe to track progress and completion for the call. The object implements the IAsyncOperationWithProgress pattern.

Attributes

DefaultOverloadAttribute OverloadAttribute RemoteAsyncAttribute

Windows requirements

Device family	Windows 10 Creators Update (introduced in 10.0.15063.0)
API contract	Windows.Foundation.UniversalApiContract (introduced in v4.0)

See also

• Package

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

Stages a Package to the system without registering it.

public:
 virtual IAsyncOperationWithProgress<DeploymentResult ^, DeploymentProgress> ^ StagePackageAsync(Uri ^ packageUri, IIterable<Uri ^> ^ dependencyPackageUris, DeploymentOptions options, PackageVolume ^ targetVolume, IIterable<Platform::String ^> ^ optionalPackageFamilyNames, IIterable<Uri ^> ^ packageUrisToInstall, IIterable<Uri ^> ^ relatedPackageUris) = StagePackageAsync;

/// [Windows.Foundation.Metadata.Overload("StagePackageToVolumeAndRelatedSetAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<DeploymentResult, DeploymentProgress> StagePackageAsync(Uri const& packageUri, IIterable<Uri> const& dependencyPackageUris, DeploymentOptions const& options, PackageVolume const& targetVolume, IIterable<winrt::hstring> const& optionalPackageFamilyNames, IIterable<Uri> const& packageUrisToInstall, IIterable<Uri> const& relatedPackageUris);

[Windows.Foundation.Metadata.Overload("StagePackageToVolumeAndRelatedSetAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<DeploymentResult,DeploymentProgress> StagePackageAsync(System.Uri packageUri, IEnumerable<System.Uri> dependencyPackageUris, DeploymentOptions options, PackageVolume targetVolume, IEnumerable<string> optionalPackageFamilyNames, IEnumerable<System.Uri> packageUrisToInstall, IEnumerable<System.Uri> relatedPackageUris);

function stagePackageAsync(packageUri, dependencyPackageUris, options, targetVolume, optionalPackageFamilyNames, packageUrisToInstall, relatedPackageUris)

Public Function StagePackageAsync (packageUri As Uri, dependencyPackageUris As IEnumerable(Of Uri), options As DeploymentOptions, targetVolume As PackageVolume, optionalPackageFamilyNames As IEnumerable(Of String), packageUrisToInstall As IEnumerable(Of Uri), relatedPackageUris As IEnumerable(Of Uri)) As IAsyncOperationWithProgress(Of DeploymentResult, DeploymentProgress)

Parameters

packageUri

Uri Uri

The source URI of the main package.

dependencyPackageUris

IIterable<Uri>

IEnumerable<Uri>

The URIs of framework dependencies to add. If there are no dependency packages or if the dependency packages are already registered, this parameter can be null.

options

DeploymentOptions

The deployment options for the package.

targetVolume

PackageVolume

The volume to which the package is added.

optionalPackageFamilyNames

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

The package family names from the main bundle to be staged.

packageUrisToInstall

IIterable<Uri>

IEnumerable<Uri>

relatedPackageUris

IIterable<Uri>

IEnumerable<Uri>

The URIs of additional packages in the main bundle that should be staged.

Returns

IAsyncOperationWithProgress<DeploymentResult,DeploymentProgress>

The status of the deployment request. The DeploymentResult contains the final returned value of the deployment operation, once it is completed. The DeploymentProgress can be used to obtain the percentage of completion over the entire course of the deployment operation.

Attributes

OverloadAttribute RemoteAsyncAttribute

Windows requirements

Device family	Windows 10 Fall Creators Update (introduced in 10.0.16299.0)
API contract	Windows.Foundation.UniversalApiContract (introduced in v5.0)

See also

• Package