PackageDeploymentManager.AddPackageByUriAsync(Uri, AddPackageOptions) Método
Definición
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í.
public:
virtual IAsyncOperationWithProgress<PackageDeploymentResult ^, PackageDeploymentProgress> ^ AddPackageByUriAsync(Uri ^ packageUri, AddPackageOptions ^ options) = AddPackageByUriAsync;IAsyncOperationWithProgress<PackageDeploymentResult, PackageDeploymentProgress> AddPackageByUriAsync(Uri const& packageUri, AddPackageOptions const& options);public IAsyncOperationWithProgress<PackageDeploymentResult,PackageDeploymentProgress> AddPackageByUriAsync(System.Uri packageUri, AddPackageOptions options);function addPackageByUriAsync(packageUri, options)Public Function AddPackageByUriAsync (packageUri As Uri, options As AddPackageOptions) As IAsyncOperationWithProgress(Of PackageDeploymentResult, PackageDeploymentProgress)Parámetros
Identificador URI del paquete que se va a agregar. El URI puede usar el esquema de URI de archivo (file://) para las rutas de acceso de archivo locales y las rutas de acceso de red locales. También se admiten protocolos HTTP y HTTPS. A partir de Windows compilación 22556, el URI puede apuntar a un paquete o a un archivo del instalador de aplicación.
- options
- AddPackageOptions
Las opciones de implementación del paquete para la operación.
Devoluciones
Estado de la solicitud de implementación. DeploymentResult contiene el valor devuelto final de la operación de implementación, una vez completado. PackageDeploymentProgress se puede usar para obtener el porcentaje de finalización durante todo el curso de la operación de implementación.
Ejemplos
Una aplicación fabrikam que instala el paquete de ejemplo de Contoso desde un https: origen.
void Install()
{
var package = new Uri("https://contoso.com/example.msix");
var packageDeploymentManager = PackageDeploymentManager.GetDefault();
var options = new AddPackageOptions();
var deploymentResult = await packageDeploymentManager.AddPackageByUriAsync(package, options);
if (deplymentResult.Status == PackageDeploymentStatus.CompletedSuccess)
{
Console.WriteLine("OK");
}
else
{
Console.WriteLine("Error:{} ExtendedError:{} {}",
deploymentResult.Error.HResult, deploymentResult.ExtendedError.HResult, deploymentResult.ErrorText);
}
}
Comentarios
Puede usar la propiedad ExternalLocationURI del parámetro options para especificar el URI de una ubicación de disco externo fuera del paquete MSIX donde el manifiesto del paquete puede hacer referencia al contenido de la aplicación. Para obtener más información sobre este escenario y un ejemplo de código relacionado, consulte Concesión de la identidad del paquete mediante el empaquetado con ubicación externa.
Puede usar la propiedad AllowUnsigned del parámetro options para permitir la información de activación de un archivo ejecutable en un paquete sin firmar.