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)

Параметры

packageUri
Uri Uri

Универсальный код ресурса (URI) добавляемого пакета. URI должен соответствовать схеме URI файла (file://), так как поддерживаются только локальные пути к файлам и локальные сетевые пути.

dependencyPackageUris

IIterable<Uri>

IEnumerable<Uri>

URI добавляемых пакетов зависимостей. Если пакеты зависимостей отсутствуют или пакеты зависимостей уже зарегистрированы, этот параметр может иметь значение NULL.

deploymentOptions
DeploymentOptions

Допустимое значение перечисления из перечисления DeploymentOptions .

targetVolume
PackageVolume

Том, на который установлен пакет.

optionalPackageFamilyNames

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

Строки, указывающие необязательные имена семейств пакетов из пакета main для промежуточной подготовки и регистрации.

relatedPackageUris

IIterable<Uri>

IEnumerable<Uri>

Универсальные коды ресурса (URI) дополнительных пакетов в пакете main, которые должны быть подготовлены и зарегистрированы.

packageUrisToInstall

IIterable<Uri>

IEnumerable<Uri>

Список других 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)

Параметры

packageUri
Uri Uri

Универсальный код ресурса (URI) добавляемого пакета. URI должен соответствовать схеме URI файла (file://), так как поддерживаются только локальные пути к файлам и локальные сетевые пути.

dependencyPackageUris

IIterable<Uri>

IEnumerable<Uri>

URI добавляемых пакетов зависимостей. Если пакеты зависимостей отсутствуют или пакеты зависимостей уже зарегистрированы, этот параметр может иметь значение NULL.

deploymentOptions
DeploymentOptions

Допустимое значение перечисления из перечисления DeploymentOptions .

targetVolume
PackageVolume

Том, на который установлен пакет.

optionalPackageFamilyNames

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

Строки, указывающие необязательные имена семейств пакетов из пакета main для промежуточной подготовки и регистрации.

relatedPackageUris

IIterable<Uri>

IEnumerable<Uri>

Универсальные коды ресурса (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.
        }
    }
}

См. также раздел

Применяется к