PackageManager.AddPackageByUriAsync(Uri, AddPackageOptions) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
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.