PackageManager.AddPackageByUriAsync(Uri, AddPackageOptions) 方法

定义

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

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

操作的包部署选项。

返回

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

属性

Windows 要求

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

注解

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

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

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

适用于

另请参阅