PackageManager.RequestAddPackageAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
RequestAddPackageAsync(Uri, IIterable<Uri>, DeploymentOptions, PackageVolume, IIterable<String>, IIterable<Uri>, IIterable<Uri>) |
Запрашивает проверка SmartScreen и проверку пользователя перед установкой пакетов приложений. Этот метод предоставляет перегрузку packageUrisToInstall для указания внешних пакетов для промежуточного размещения и регистрации. |
RequestAddPackageAsync(Uri, IIterable<Uri>, DeploymentOptions, PackageVolume, IIterable<String>, IIterable<Uri>) |
Запрашивает проверка SmartScreen и проверку пользователя перед установкой пакетов приложений. |
RequestAddPackageAsync(Uri, IIterable<Uri>, DeploymentOptions, PackageVolume, IIterable<String>, IIterable<Uri>, IIterable<Uri>)
Запрашивает проверка SmartScreen и проверку пользователя перед установкой пакетов приложений. Этот метод предоставляет перегрузку packageUrisToInstall для указания внешних пакетов для промежуточного размещения и регистрации.
public:
virtual IAsyncOperationWithProgress<DeploymentResult ^, DeploymentProgress> ^ RequestAddPackageAsync(Uri ^ packageUri, IIterable<Uri ^> ^ dependencyPackageUris, DeploymentOptions deploymentOptions, PackageVolume ^ targetVolume, IIterable<Platform::String ^> ^ optionalPackageFamilyNames, IIterable<Uri ^> ^ relatedPackageUris, IIterable<Uri ^> ^ packageUrisToInstall) = RequestAddPackageAsync;
/// [Windows.Foundation.Metadata.Overload("RequestAddPackageAndRelatedSetAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<DeploymentResult, DeploymentProgress> RequestAddPackageAsync(Uri const& packageUri, IIterable<Uri> const& dependencyPackageUris, DeploymentOptions const& deploymentOptions, PackageVolume const& targetVolume, IIterable<winrt::hstring> const& optionalPackageFamilyNames, IIterable<Uri> const& relatedPackageUris, IIterable<Uri> const& packageUrisToInstall);
[Windows.Foundation.Metadata.Overload("RequestAddPackageAndRelatedSetAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<DeploymentResult,DeploymentProgress> RequestAddPackageAsync(System.Uri packageUri, IEnumerable<System.Uri> dependencyPackageUris, DeploymentOptions deploymentOptions, PackageVolume targetVolume, IEnumerable<string> optionalPackageFamilyNames, IEnumerable<System.Uri> relatedPackageUris, IEnumerable<System.Uri> packageUrisToInstall);
function requestAddPackageAsync(packageUri, dependencyPackageUris, deploymentOptions, targetVolume, optionalPackageFamilyNames, relatedPackageUris, packageUrisToInstall)
Public Function RequestAddPackageAsync (packageUri As Uri, dependencyPackageUris As IEnumerable(Of Uri), deploymentOptions As DeploymentOptions, targetVolume As PackageVolume, optionalPackageFamilyNames As IEnumerable(Of String), relatedPackageUris As IEnumerable(Of Uri), packageUrisToInstall As IEnumerable(Of Uri)) As IAsyncOperationWithProgress(Of DeploymentResult, DeploymentProgress)
Параметры
Универсальный код ресурса (URI) добавляемого пакета. URI должен соответствовать схеме URI файла (file://), так как поддерживаются только локальные пути к файлам и локальные сетевые пути.
- dependencyPackageUris
URI добавляемых пакетов зависимостей. Если пакеты зависимостей отсутствуют или пакеты зависимостей уже зарегистрированы, этот параметр может иметь значение NULL.
- deploymentOptions
- DeploymentOptions
Допустимое значение перечисления из перечисления DeploymentOptions .
- targetVolume
- PackageVolume
Том, на который установлен пакет.
Строки, указывающие необязательные имена семейств пакетов из пакета main для промежуточной подготовки и регистрации.
- relatedPackageUris
Универсальные коды ресурса (URI) дополнительных пакетов в пакете main, которые должны быть подготовлены и зарегистрированы.
- packageUrisToInstall
Список других URI пакетов, которые необходимо подготовить и зарегистрировать. Он может содержать пути к устанавливаемым внешним пакетам.
Возвращаемое значение
Ход и результат добавления пакета приложения.
- Атрибуты
Требования к Windows
Семейство устройств |
Windows 10, version 1803 (появилось в 10.0.17134.0)
|
API contract |
Windows.Foundation.UniversalApiContract (появилось в v6.0)
|
См. также раздел
Применяется к
RequestAddPackageAsync(Uri, IIterable<Uri>, DeploymentOptions, PackageVolume, IIterable<String>, IIterable<Uri>)
Запрашивает проверка SmartScreen и проверку пользователя перед установкой пакетов приложений.
public:
virtual IAsyncOperationWithProgress<DeploymentResult ^, DeploymentProgress> ^ RequestAddPackageAsync(Uri ^ packageUri, IIterable<Uri ^> ^ dependencyPackageUris, DeploymentOptions deploymentOptions, PackageVolume ^ targetVolume, IIterable<Platform::String ^> ^ optionalPackageFamilyNames, IIterable<Uri ^> ^ relatedPackageUris) = RequestAddPackageAsync;
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<DeploymentResult, DeploymentProgress> RequestAddPackageAsync(Uri const& packageUri, IIterable<Uri> const& dependencyPackageUris, DeploymentOptions const& deploymentOptions, PackageVolume const& targetVolume, IIterable<winrt::hstring> const& optionalPackageFamilyNames, IIterable<Uri> const& relatedPackageUris);
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<DeploymentResult,DeploymentProgress> RequestAddPackageAsync(System.Uri packageUri, IEnumerable<System.Uri> dependencyPackageUris, DeploymentOptions deploymentOptions, PackageVolume targetVolume, IEnumerable<string> optionalPackageFamilyNames, IEnumerable<System.Uri> relatedPackageUris);
function requestAddPackageAsync(packageUri, dependencyPackageUris, deploymentOptions, targetVolume, optionalPackageFamilyNames, relatedPackageUris)
Public Function RequestAddPackageAsync (packageUri As Uri, dependencyPackageUris As IEnumerable(Of Uri), deploymentOptions As DeploymentOptions, targetVolume As PackageVolume, optionalPackageFamilyNames As IEnumerable(Of String), relatedPackageUris As IEnumerable(Of Uri)) As IAsyncOperationWithProgress(Of DeploymentResult, DeploymentProgress)
Параметры
Универсальный код ресурса (URI) добавляемого пакета. URI должен соответствовать схеме URI файла (file://), так как поддерживаются только локальные пути к файлам и локальные сетевые пути.
- dependencyPackageUris
URI добавляемых пакетов зависимостей. Если пакеты зависимостей отсутствуют или пакеты зависимостей уже зарегистрированы, этот параметр может иметь значение NULL.
- deploymentOptions
- DeploymentOptions
Допустимое значение перечисления из перечисления DeploymentOptions .
- targetVolume
- PackageVolume
Том, на который установлен пакет.
Строки, указывающие необязательные имена семейств пакетов из пакета main для промежуточной подготовки и регистрации.
- relatedPackageUris
Универсальные коды ресурса (URI) дополнительных пакетов в пакете main, которые должны быть подготовлены и зарегистрированы.
Возвращаемое значение
Ход выполнения и результат развертывания пакета приложения.
- Атрибуты
Требования к Windows
Семейство устройств |
Windows 10 Fall Creators Update (появилось в 10.0.16299.0)
|
API contract |
Windows.Foundation.UniversalApiContract (появилось в v5.0)
|
Примеры
В примере показано, как использовать RequestAddPackageAsync в приложении UWP, подключив его к обработчику нажатия кнопки. Это вызовет окно пользовательского интерфейса запроса SmartScreen.
public async void OnInstallNowClicked(object sender, RoutedEventArgs args)
{
var packageManager = new PackageManager();
DeploymentOperation result = await packageManager.RequestAddPackageAsync(
this.currentPackageUri,
null /*no dependencies*/,
DeploymentOptions.None,
null /*stage to default package volume*/,
null /*no optional packages*/,
null /*no external packages*/);
if (result.ExtendedErrorCode != null)
{
if (result.ExtendedErrorCode.HResult == 0x80073d01)
{
// SmartScreen blocked the app installation.
}
else
{
// The app installation failed for another reason.
}
}
}