Compartir a través de


PackageManager.RequestAddPackageAsync Método

Definición

Sobrecargas

RequestAddPackageAsync(Uri, IIterable<Uri>, DeploymentOptions, PackageVolume, IIterable<String>, IIterable<Uri>, IIterable<Uri>)

Solicita una comprobación de SmartScreen y una comprobación del usuario antes de instalar los paquetes de la aplicación. Este método proporciona una sobrecarga packageUrisToInstall para especificar los paquetes externos que se van a almacenar provisionalmente y registrar.

RequestAddPackageAsync(Uri, IIterable<Uri>, DeploymentOptions, PackageVolume, IIterable<String>, IIterable<Uri>)

Solicita una comprobación de SmartScreen y una comprobación del usuario antes de instalar los paquetes de la aplicación.

RequestAddPackageAsync(Uri, IIterable<Uri>, DeploymentOptions, PackageVolume, IIterable<String>, IIterable<Uri>, IIterable<Uri>)

Solicita una comprobación de SmartScreen y una comprobación del usuario antes de instalar los paquetes de la aplicación. Este método proporciona una sobrecarga packageUrisToInstall para especificar los paquetes externos que se van a almacenar provisionalmente y registrar.

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)

Parámetros

packageUri
Uri Uri

URI del paquete que se va a agregar. El URI debe seguir el esquema de URI de archivo (file://), ya que los únicos esquemas de URI admitidos son rutas de acceso de archivo locales y rutas de red locales.

dependencyPackageUris

IIterable<Uri>

IEnumerable<Uri>

URI de los paquetes de dependencia que se van a agregar. Si no hay ningún paquete de dependencia o si los paquetes de dependencia ya están registrados, este parámetro puede ser NULL.

deploymentOptions
DeploymentOptions

Valor de enumeración válido de la enumeración DeploymentOptions .

targetVolume
PackageVolume

Volumen en el que se instala el paquete.

optionalPackageFamilyNames

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

Cadenas que especifican los nombres de familia de paquetes opcionales de la agrupación principal que se van a almacenar provisionalmente y registrar.

relatedPackageUris

IIterable<Uri>

IEnumerable<Uri>

Los URI de paquetes adicionales del paquete principal que se deben almacenar provisionalmente y registrar.

packageUrisToInstall

IIterable<Uri>

IEnumerable<Uri>

Lista de otros URI de paquete que se van a almacenar provisionalmente y registrar. Esto puede contener rutas de acceso a paquetes externos que se van a instalar.

Devoluciones

Progreso y resultado de agregar el paquete de la aplicación.

Atributos

Requisitos de Windows

Familia de dispositivos
Windows 10, version 1803 (se introdujo en la versión 10.0.17134.0)
API contract
Windows.Foundation.UniversalApiContract (se introdujo en la versión v6.0)

Consulte también

Se aplica a

RequestAddPackageAsync(Uri, IIterable<Uri>, DeploymentOptions, PackageVolume, IIterable<String>, IIterable<Uri>)

Solicita una comprobación de SmartScreen y una comprobación del usuario antes de instalar los paquetes de la aplicación.

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)

Parámetros

packageUri
Uri Uri

URI del paquete que se va a agregar. El URI debe seguir el esquema de URI de archivo (file://), ya que los únicos esquemas de URI admitidos son rutas de acceso de archivo locales y rutas de red locales.

dependencyPackageUris

IIterable<Uri>

IEnumerable<Uri>

URI de los paquetes de dependencia que se van a agregar. Si no hay ningún paquete de dependencia o si los paquetes de dependencia ya están registrados, este parámetro puede ser NULL.

deploymentOptions
DeploymentOptions

Valor de enumeración válido de la enumeración DeploymentOptions .

targetVolume
PackageVolume

Volumen en el que se instala el paquete.

optionalPackageFamilyNames

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

Cadenas que especifican los nombres de familia de paquetes opcionales de la agrupación principal que se van a almacenar provisionalmente y registrar.

relatedPackageUris

IIterable<Uri>

IEnumerable<Uri>

Los URI de paquetes adicionales del paquete principal que se deben almacenar provisionalmente y registrar.

Devoluciones

El progreso y el resultado de la implementación del paquete de la aplicación.

Atributos

Requisitos de Windows

Familia de dispositivos
Windows 10 Fall Creators Update (se introdujo en la versión 10.0.16299.0)
API contract
Windows.Foundation.UniversalApiContract (se introdujo en la versión v5.0)

Ejemplos

En el ejemplo se muestra cómo usar RequestAddPackageAsync en una aplicación para UWP mediante el enlace a un controlador de clics de botón. Esto invocará la ventana de interfaz de usuario de solicitud de 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.
        }
    }
}

Consulte también

Se aplica a