StoreContext.RequestDownloadAndInstallStorePackagesAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
| RequestDownloadAndInstallStorePackagesAsync(IIterable<String>) |
Пытается скачать и установить указанные пакеты загружаемого содержимого (DLC) для текущего приложения из Microsoft Store. Этот метод также отображает диалоговое окно пользовательского интерфейса, которое запрашивает разрешение для операции. Важно! Этот метод должен вызываться в потоке пользовательского интерфейса. |
| RequestDownloadAndInstallStorePackagesAsync(IIterable<String>, StorePackageInstallOptions) |
Пытается скачать и установить указанные пакеты загружаемого содержимого (DLC) для текущего приложения из Microsoft Store с указанными параметрами установки. Этот метод также отображает диалоговое окно пользовательского интерфейса, которое запрашивает разрешение для операции. Важно! Этот метод должен вызываться в потоке пользовательского интерфейса. |
RequestDownloadAndInstallStorePackagesAsync(IIterable<String>)
Пытается скачать и установить указанные пакеты загружаемого содержимого (DLC) для текущего приложения из Microsoft Store. Этот метод также отображает диалоговое окно пользовательского интерфейса, которое запрашивает разрешение для операции.
Важно!
Этот метод должен вызываться в потоке пользовательского интерфейса.
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)Параметры
Идентификаторы магазинов устанавливаемых надстроек DLC.
Возвращаемое значение
Объект, который вызывающий объект может наблюдать для отслеживания хода выполнения и завершения операции. При успешном завершении результатом будет объект StorePackageUpdateResult , предоставляющий сведения об обновлениях пакета.
- Атрибуты
Исключения
Если свойство ErrorCode исключения имеет значение 0x80070578 (ERROR_INVALID_WINDOW_HANDLE), это означает, что метод не был вызван в потоке пользовательского интерфейса. Если вы вызываете этот метод в классическом приложении, которое использует мост для классических приложений, это также может означать, что вы не настроили <объект xref:Windows.Services.Store.StoreContext?text=StoreContext>, чтобы указать, какое окно приложения является окном-владельцем для модальных диалогов, отображаемых этим методом. Дополнительные сведения см. в этой статье.
Комментарии
Используйте этот метод для скачивания и установки новых пакетов DLC для текущего приложения. При вызове этого метода ОС отображает диалоговое окно, в котором сообщается, что пакет приложения доступен для скачивания и установки, и запрашивается разрешение пользователя на продолжение операции. Если пользователь не предоставляет разрешение, свойство OverallState возвращаемого значения StorePackageUpdateResult имеет значение Canceled. Чтобы автоматически установить пакет приложения без отображения диалогового окна уведомления, используйте DownloadAndInstallStorePackagesAsync (для этого метода требуется доступ к ограниченной возможности).
Идентификатор Магазина для надстройки DLC доступен в Центре партнеров, а также возвращается свойством StoreIdобъекта StoreProduct , представляющего надстройку DLC. Дополнительные сведения см. в разделе Идентификаторы Магазинов.
Эта операция не блокируется. Объект IAsyncOperationWithProgress , возвращенный этим методом, завершится после загрузки и установки пакетов.
Метод, назначаемый для обработки уведомлений о ходе выполнения, вызывается один раз для каждого шага в процессе загрузки и установки для каждого пакета в этом запросе. Обработчик хода выполнения получает аргумент StorePackageUpdateStatus , который предоставляет сведения о пакете, вызвавшим уведомление о ходе выполнения.
Примечание
Загружаемые пакеты содержимого (DLC) доступны не для всех учетных записей разработчиков.
См. также раздел
- DownloadAndInstallStorePackagesAsync(IIterable<String>)
- Разработка дополнительных пакетов и связанных наборов
Применяется к
RequestDownloadAndInstallStorePackagesAsync(IIterable<String>, StorePackageInstallOptions)
Пытается скачать и установить указанные пакеты загружаемого содержимого (DLC) для текущего приложения из Microsoft Store с указанными параметрами установки. Этот метод также отображает диалоговое окно пользовательского интерфейса, которое запрашивает разрешение для операции.
Важно!
Этот метод должен вызываться в потоке пользовательского интерфейса.
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)Параметры
Идентификаторы магазинов устанавливаемых надстроек DLC.
- storePackageInstallOptions
- StorePackageInstallOptions
Объект , указывающий параметры установки для операции.
Возвращаемое значение
Объект, который вызывающий объект может наблюдать для отслеживания хода выполнения и завершения операции. При успешном завершении результатом будет объект StorePackageUpdateResult , предоставляющий сведения об обновлениях пакета.
- Атрибуты
Исключения
Если свойство ErrorCode исключения имеет значение 0x80070578 (ERROR_INVALID_WINDOW_HANDLE), это означает, что метод не был вызван в потоке пользовательского интерфейса. Если вы вызываете этот метод в классическом приложении, которое использует мост для классических приложений, это также может означать, что вы не настроили <объект 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 для текущего приложения. Эта перегрузка позволяет указать, может ли ОС принудительно перезапустить приложение после установки пакетов DLC, задав свойство AllowForcedAppRestart параметра storePackageInstallOptions .
При вызове этого метода ОС отображает диалоговое окно, в котором сообщается, что пакет приложения доступен для скачивания и установки, и запрашивается разрешение пользователя на продолжение операции. Если пользователь не предоставляет разрешение, свойство OverallState возвращаемого значения StorePackageUpdateResult имеет значение Canceled. Чтобы автоматически установить пакет приложения без отображения диалогового окна уведомления, используйте DownloadAndInstallStorePackagesAsync (для этого метода требуется доступ к ограниченной возможности).
Идентификатор Магазина для надстройки DLC доступен в Центре партнеров, а также возвращается свойством StoreIdобъекта StoreProduct , представляющего надстройку DLC. Дополнительные сведения см. в разделе Идентификаторы Магазинов.
Эта операция не блокируется. Объект IAsyncOperationWithProgress , возвращенный этим методом, завершится после загрузки и установки пакетов.
Метод, назначаемый для обработки уведомлений о ходе выполнения, вызывается один раз для каждого шага в процессе загрузки и установки для каждого пакета в этом запросе. Обработчик хода выполнения получает аргумент StorePackageUpdateStatus , который предоставляет сведения о пакете, вызвавшим уведомление о ходе выполнения.
Примечание
Пакеты DLC доступны не для всех учетных записей разработчиков.
См. также раздел
- DownloadAndInstallStorePackagesAsync(IIterable<String>)
- Разработка дополнительных пакетов и связанных наборов
Применяется к
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по