PackageManager.RequestAddPackageAsync Método

Referencia

Definición

Espacio de nombres:: Windows.Management.Deployment

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

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>)

Editar

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

IAsyncOperationWithProgress<DeploymentResult,DeploymentProgress>

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

Atributos: OverloadAttribute RemoteAsyncAttribute

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

Paquete

Se aplica a

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

Editar

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

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

IAsyncOperationWithProgress<DeploymentResult,DeploymentProgress>

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

Atributos: RemoteAsyncAttribute

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

Paquete

Se aplica a

Compartir a través de

PackageManager.RequestAddPackageAsync Método

Definición

Sobrecargas

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

Parámetros

Devoluciones

Requisitos de Windows

Consulte también

Se aplica a

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

Parámetros

Devoluciones

Requisitos de Windows

Ejemplos

Consulte también

Se aplica a

Comentarios

Recursos adicionales