PackageManager.AddPackageByUriAsync(Uri, AddPackageOptions) 方法

定义

命名空间:

Windows.Management.Deployment

使用指定的部署选项为当前用户添加包 (主包) 和任何其他依赖项包。

public:
 virtual IAsyncOperationWithProgress<DeploymentResult ^, DeploymentProgress> ^ AddPackageByUriAsync(Uri ^ packageUri, AddPackageOptions ^ options) = AddPackageByUriAsync;

/// [Windows.Foundation.Metadata.Overload("AddPackageByUriAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<DeploymentResult, DeploymentProgress> AddPackageByUriAsync(Uri const& packageUri, AddPackageOptions const& options);

[Windows.Foundation.Metadata.Overload("AddPackageByUriAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<DeploymentResult,DeploymentProgress> AddPackageByUriAsync(System.Uri packageUri, AddPackageOptions options);

function addPackageByUriAsync(packageUri, options)

Public Function AddPackageByUriAsync (packageUri As Uri, options As AddPackageOptions) As IAsyncOperationWithProgress(Of DeploymentResult, DeploymentProgress)

参数

packageUri

Uri Uri

要添加的包的 URI。 URI 可以将文件 URI 方案 (file：//) 用于本地文件路径和本地网络路径。 还支持 HTTP 和 HTTPS 协议。 从 Windows 内部版本 22556 开始，URI 可以指向包或应用安装程序文件。

options

AddPackageOptions

操作的包部署选项。

返回

IAsyncOperationWithProgress<DeploymentResult,DeploymentProgress>

部署请求的状态。 DeploymentResult 包含部署操作的最终返回值（完成后）。 DeploymentProgress 可用于获取整个部署操作过程中的完成百分比。

属性

OverloadAttribute RemoteAsyncAttribute

Windows 要求

设备系列	Windows 10, version 2004 (在 10.0.19041.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v10.0 中引入)

注解

此方法通过将所有部署选项合并到单个参数中，简化了现有的 AddPackageAsync 重载。 此方法还支持 AddPackageAsync 重载中不可用的以下功能：

• 可以使用 options 参数的 ExternalLocationURI 属性指定 MSIX 包外部的外部磁盘位置的 URI，包清单可在其中引用应用程序内容。 有关此方案和相关代码示例的详细信息，请参阅 使用外部位置打包来授予包标识。

• 可以使用 options 参数的 AllowUnsigned 属性来允许未签名包中可执行文件的激活信息。 有关此方案和相关代码示例的详细信息，请参阅 托管应用。

另请参阅

• AddPackageOptions
• 包
• 通过使用外部位置进行打包来授予包标识
• 托管的应用