Compartilhar via


PackageManager.AddPackageByUriAsync(Uri, AddPackageOptions) Método

Definição

Adiciona um Pacote (o pacote principal) e quaisquer pacotes de dependência adicionais, para o usuário atual, usando as opções de implantação especificadas.

public:
 virtual IAsyncOperationWithProgress<DeploymentResult ^, DeploymentProgress> ^ AddPackageByUriAsync(Uri ^ packageUri, AddPackageOptions ^ options) = AddPackageByUriAsync;
/// [Windows.Foundation.Metadata.Overload("AddPackageByUriAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<DeploymentResult, DeploymentProgress> AddPackageByUriAsync(Uri const& packageUri, AddPackageOptions const& options);
[Windows.Foundation.Metadata.Overload("AddPackageByUriAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<DeploymentResult,DeploymentProgress> AddPackageByUriAsync(System.Uri packageUri, AddPackageOptions options);
function addPackageByUriAsync(packageUri, options)
Public Function AddPackageByUriAsync (packageUri As Uri, options As AddPackageOptions) As IAsyncOperationWithProgress(Of DeploymentResult, DeploymentProgress)

Parâmetros

packageUri
Uri Uri

O URI do pacote a ser adicionado. O URI pode usar o esquema de URI de arquivo (file://) para caminhos de arquivo locais e caminhos de rede local. Também há suporte para protocolos HTTP e HTTPS. A partir do Build 22556 do Windows, o URI pode apontar para um pacote ou um arquivo do Instalador de Aplicativo.

options
AddPackageOptions

As opções de implantação do pacote para a operação.

Retornos

O status da solicitação de implantação. O DeploymentResult contém o valor final retornado da operação de implantação, depois que ela é concluída. O DeploymentProgress pode ser usado para obter o percentual de conclusão durante todo o curso da operação de implantação.

Atributos

Requisitos do Windows

Família de dispositivos
Windows 10, version 2004 (introduzida na 10.0.19041.0)
API contract
Windows.Foundation.UniversalApiContract (introduzida na v10.0)

Comentários

Esse método simplifica as sobrecargas AddPackageAsync existentes consolidando todas as opções de implantação em um único parâmetro. Esse método também dá suporte aos seguintes recursos não disponíveis com as sobrecargas AddPackageAsync :

  • Você pode usar a propriedade ExternalLocationURI do parâmetro options para especificar o URI de um local de disco externo fora do pacote MSIX em que o manifesto do pacote pode referenciar o conteúdo do aplicativo. Para obter mais informações sobre esse cenário e um exemplo de código relacionado, consulte Conceder identidade do pacote empacotando com local externo.

  • Você pode usar a propriedade AllowUnsigned do parâmetro options para permitir informações de ativação de um executável em um pacote sem sinal. Para obter mais informações sobre esse cenário e um exemplo de código relacionado, consulte Aplicativos hospedados.

Aplica-se a

Confira também