通过

StoreContext.RequestDownloadAndInstallStorePackagesAsync 方法

  • 参考

定义

命名空间:
Windows.Services.Store

重载

RequestDownloadAndInstallStorePackagesAsync(IIterable<String>)

尝试从 Microsoft Store 下载并安装指定的可下载内容 (DLC) 包。 此方法还显示一个 UI 对话框，该对话框请求操作的权限。

重要

必须在 UI 线程上调用此方法。
RequestDownloadAndInstallStorePackagesAsync(IIterable<String>, StorePackageInstallOptions)

尝试使用指定的安装选项从 Microsoft Store 下载并安装指定的可下载内容 (DLC) 包。 此方法还显示一个 UI 对话框，该对话框请求操作的权限。

重要

必须在 UI 线程上调用此方法。

RequestDownloadAndInstallStorePackagesAsync(IIterable<String>)

编辑

尝试从 Microsoft Store 下载并安装指定的可下载内容 (DLC) 包。 此方法还显示一个 UI 对话框，该对话框请求操作的权限。

重要

必须在 UI 线程上调用此方法。

public:
 virtual IAsyncOperationWithProgress<StorePackageUpdateResult ^, StorePackageUpdateStatus> ^ RequestDownloadAndInstallStorePackagesAsync(IIterable<Platform::String ^> ^ storeIds) = RequestDownloadAndInstallStorePackagesAsync;
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<StorePackageUpdateResult, StorePackageUpdateStatus> RequestDownloadAndInstallStorePackagesAsync(IIterable<winrt::hstring> const& storeIds);
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<StorePackageUpdateResult,StorePackageUpdateStatus> RequestDownloadAndInstallStorePackagesAsync(IEnumerable<string> storeIds);
function requestDownloadAndInstallStorePackagesAsync(storeIds)
Public Function RequestDownloadAndInstallStorePackagesAsync (storeIds As IEnumerable(Of String)) As IAsyncOperationWithProgress(Of StorePackageUpdateResult, StorePackageUpdateStatus)

参数

storeIds

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

要安装的 DLC 加载项包的存储 ID。

返回

IAsyncOperationWithProgress<StorePackageUpdateResult,StorePackageUpdateStatus>

一个 对象，调用方可以观察该对象，用于跟踪操作的进度和完成情况。 成功完成后，结果为 StorePackageUpdateResult 对象，该对象提供有关包更新的信息。

属性
RemoteAsyncAttribute

例外

COMException

如果异常的 ErrorCode 属性具有值0x80070578 (ERROR_INVALID_WINDOW_HANDLE) ，则表示未在 UI 线程上调用该方法。 如果在使用 桌面桥的桌面应用程序中调用此方法，这可能还表示未配置 <xref：Windows.Services.Store.StoreContext？text=StoreContext> 对象，以指定哪个应用程序窗口是此方法显示的模式对话框的所有者窗口。 有关详细信息，请参阅此文章。

注解

使用此方法下载并安装当前应用的新 DLC 包。 调用此方法时，OS 会显示一个对话框，告知用户应用包可供下载和安装，并请求用户继续操作的权限。 如果用户未授予权限，StorePackageUpdateResult 返回值的 OverallState 属性具有值 Canceled。 若要在不显示通知对话框的情况下以无提示方式安装应用包，请使用 DownloadAndInstallStorePackagesAsync (此方法需要访问受限功能) 。

DLC 加载项的应用商店 ID 在合作伙伴中心中可用，并且该 ID 也由 StoreProduct 的 StoreId 属性返回，该属性表示 DLC 加载项。 有关详细信息，请参阅 存储 ID。

此操作不会阻止。 此方法返回的 IAsyncOperationWithProgress 对象将在下载并安装包后完成。

分配用于处理 进度 通知的方法对于此请求中每个包的下载和安装过程中的每个步骤调用一次。 Progress 处理程序接收 StorePackageUpdateStatus 参数，该参数提供有关引发进度通知的包的信息。

注意

(DLC) 包的可下载内容并非适用于所有开发人员帐户。

另请参阅

适用于

RequestDownloadAndInstallStorePackagesAsync(IIterable<String>, StorePackageInstallOptions)

编辑

尝试使用指定的安装选项从 Microsoft Store 下载并安装指定的可下载内容 (DLC) 包。 此方法还显示一个 UI 对话框，该对话框请求操作的权限。

重要

必须在 UI 线程上调用此方法。

public:
 virtual IAsyncOperationWithProgress<StorePackageUpdateResult ^, StorePackageUpdateStatus> ^ RequestDownloadAndInstallStorePackagesAsync(IIterable<Platform::String ^> ^ storeIds, StorePackageInstallOptions ^ storePackageInstallOptions) = RequestDownloadAndInstallStorePackagesAsync;
/// [Windows.Foundation.Metadata.Overload("RequestDownloadAndInstallStorePackagesWithInstallOptionsAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<StorePackageUpdateResult, StorePackageUpdateStatus> RequestDownloadAndInstallStorePackagesAsync(IIterable<winrt::hstring> const& storeIds, StorePackageInstallOptions const& storePackageInstallOptions);
[Windows.Foundation.Metadata.Overload("RequestDownloadAndInstallStorePackagesWithInstallOptionsAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<StorePackageUpdateResult,StorePackageUpdateStatus> RequestDownloadAndInstallStorePackagesAsync(IEnumerable<string> storeIds, StorePackageInstallOptions storePackageInstallOptions);
function requestDownloadAndInstallStorePackagesAsync(storeIds, storePackageInstallOptions)
Public Function RequestDownloadAndInstallStorePackagesAsync (storeIds As IEnumerable(Of String), storePackageInstallOptions As StorePackageInstallOptions) As IAsyncOperationWithProgress(Of StorePackageUpdateResult, StorePackageUpdateStatus)

参数

storeIds

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

要安装的 DLC 加载项包的存储 ID。

storePackageInstallOptions
StorePackageInstallOptions

一个 对象，该对象指定操作的安装选项。

返回

IAsyncOperationWithProgress<StorePackageUpdateResult,StorePackageUpdateStatus>

一个 对象，调用方可以观察该对象，用于跟踪操作的进度和完成情况。 成功完成后，结果为 StorePackageUpdateResult 对象，该对象提供有关包更新的信息。

属性
OverloadAttribute RemoteAsyncAttribute

例外

COMException

如果异常的 ErrorCode 属性具有值0x80070578 (ERROR_INVALID_WINDOW_HANDLE) ，则表示未在 UI 线程上调用该方法。 如果在使用 桌面桥的桌面应用程序中调用此方法，这可能还表示未配置 <xref：Windows.Services.Store.StoreContext？text=StoreContext> 对象，以指定哪个应用程序窗口是此方法显示的模式对话框的所有者窗口。 有关详细信息，请参阅此文章。

Windows 要求

设备系列
Windows 10, version 1803 (在 10.0.17134.0 中引入)
API contract
Windows.Services.Store.StoreContract (在 v3.0 中引入)

注解

使用此方法下载并安装当前应用的新 DLC 包。 此重载提供了一个选项，用于指定 OS 是否可以通过设置 storePackageInstallOptions 参数的 AllowForcedAppRestart 属性在安装 DLC 包后强制应用重启。

调用此方法时，OS 会显示一个对话框，告知用户应用包可供下载和安装，并请求用户继续操作的权限。 如果用户未授予权限，StorePackageUpdateResult 返回值的 OverallState 属性具有值 Canceled。 若要在不显示通知对话框的情况下以无提示方式安装应用包，请使用 DownloadAndInstallStorePackagesAsync (此方法需要访问受限功能) 。

DLC 加载项的应用商店 ID 在合作伙伴中心中可用，并且该 ID 也由 StoreProduct 的 StoreId 属性返回，该属性表示 DLC 加载项。 有关详细信息，请参阅 存储 ID。

此操作不会阻止。 此方法返回的 IAsyncOperationWithProgress 对象将在下载并安装包后完成。

分配用于处理 进度 通知的方法对于此请求中每个包的下载和安装过程中的每个步骤调用一次。 Progress 处理程序接收 StorePackageUpdateStatus 参数，该参数提供有关引发进度通知的包的信息。

注意

DLC 包并非适用于所有开发人员帐户。

另请参阅

适用于