PackageManager.RequestAddPackageAsync 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.
Sobrecargas
| RequestAddPackageAsync(Uri, IIterable<Uri>, DeploymentOptions, PackageVolume, IIterable<String>, IIterable<Uri>, IIterable<Uri>) |
Solicita um marcar SmartScreen e a verificação do usuário antes de instalar os Pacotes do aplicativo. Esse método fornece uma sobrecarga packageUrisToInstall para especificar pacotes externos a serem preparados e registrados. |
| RequestAddPackageAsync(Uri, IIterable<Uri>, DeploymentOptions, PackageVolume, IIterable<String>, IIterable<Uri>) |
Solicita um marcar SmartScreen e a verificação do usuário antes de instalar os Pacotes do aplicativo. |
RequestAddPackageAsync(Uri, IIterable<Uri>, DeploymentOptions, PackageVolume, IIterable<String>, IIterable<Uri>, IIterable<Uri>)
Solicita um marcar SmartScreen e a verificação do usuário antes de instalar os Pacotes do aplicativo. Esse método fornece uma sobrecarga packageUrisToInstall para especificar pacotes externos a serem preparados e registrados.
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
O URI do pacote a ser adicionado. O URI deve seguir o esquema de URI do arquivo (file://), pois os únicos esquemas de URI com suporte são caminhos de arquivo locais e caminhos de rede local.
- dependencyPackageUris
Os URIs dos pacotes de dependência a serem adicionados. Se não houver pacotes de dependência ou se os pacotes de dependência já estiverem registrados, esse parâmetro poderá ser nulo.
- deploymentOptions
- DeploymentOptions
Um valor de enumeração válido da enumeração DeploymentOptions .
- targetVolume
- PackageVolume
O volume no qual o pacote está instalado.
Cadeias de caracteres que especificam os nomes de família de pacotes opcionais do pacote main a serem preparados e registrados.
- relatedPackageUris
Os URIs de pacotes adicionais no pacote main que devem ser preparados e registrados.
- packageUrisToInstall
Uma lista de outros URIs de pacote a serem preparados e registrados. Isso pode conter caminhos para pacotes externos a serem instalados.
Retornos
O progresso e o resultado da adição do pacote do aplicativo.
- Atributos
Requisitos do Windows
| Família de dispositivos |
Windows 10, version 1803 (introduzida na 10.0.17134.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduzida na v6.0)
|
Confira também
Aplica-se a
RequestAddPackageAsync(Uri, IIterable<Uri>, DeploymentOptions, PackageVolume, IIterable<String>, IIterable<Uri>)
Solicita um marcar SmartScreen e a verificação do usuário antes de instalar os Pacotes do aplicativo.
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
O URI do pacote a ser adicionado. O URI deve seguir o esquema de URI do arquivo (file://), pois os únicos esquemas de URI com suporte são caminhos de arquivo locais e caminhos de rede local.
- dependencyPackageUris
Os URIs dos pacotes de dependência a serem adicionados. Se não houver pacotes de dependência ou se os pacotes de dependência já estiverem registrados, esse parâmetro poderá ser nulo.
- deploymentOptions
- DeploymentOptions
Um valor de enumeração válido da enumeração DeploymentOptions .
- targetVolume
- PackageVolume
O volume no qual o pacote está instalado.
Cadeias de caracteres que especificam os nomes de família de pacotes opcionais do pacote main a serem preparados e registrados.
- relatedPackageUris
Os URIs de pacotes adicionais no pacote main que devem ser preparados e registrados.
Retornos
O progresso e o resultado da implantação do pacote do aplicativo.
- Atributos
Requisitos do Windows
| Família de dispositivos |
Windows 10 Fall Creators Update (introduzida na 10.0.16299.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduzida na v5.0)
|
Exemplos
O exemplo demonstra como usar RequestAddPackageAsync em um aplicativo UWP conectando-o a um manipulador de cliques de botão. Isso invocará a janela da interface do usuário de solicitação do 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.
}
}
}