PackageManager.AddPackageByUriAsync(Uri, AddPackageOptions) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Fügt ein Paket (das Hauptpaket) und alle zusätzlichen Abhängigkeitspakete für den aktuellen Benutzer mithilfe der angegebenen Bereitstellungsoptionen hinzu.
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)
Parameter
Der URI des hinzuzufügenden Pakets. Der URI kann das Datei-URI-Schema (file://) für lokale Dateipfade und lokale Netzwerkpfade verwenden. HTTP- und HTTPS-Protokolle werden ebenfalls unterstützt. Ab Windows Build 22556 kann der URI auf ein Paket oder eine App Installer-Datei verweisen.
- options
- AddPackageOptions
Die Paketbereitstellungsoptionen für den Vorgang.
Gibt zurück
Der Status der Bereitstellungsanforderung. DeploymentResult enthält den letzten zurückgegebenen Wert des Bereitstellungsvorgangs, sobald er abgeschlossen ist. DeploymentProgress kann verwendet werden, um den Prozentsatz der Fertigstellung über den gesamten Verlauf des Bereitstellungsvorgangs abzurufen.
- Attribute
Windows-Anforderungen
Gerätefamilie |
Windows 10, version 2004 (eingeführt in 10.0.19041.0)
|
API contract |
Windows.Foundation.UniversalApiContract (eingeführt in v10.0)
|
Hinweise
Diese Methode vereinfacht die vorhandenen AddPackageAsync-Überladungen , indem alle Bereitstellungsoptionen in einem einzelnen Parameter konsolidiert werden. Diese Methode unterstützt auch die folgenden Features, die mit den AddPackageAsync-Überladungen nicht verfügbar sind:
Sie können die ExternalLocationURI-Eigenschaft des options-Parameters verwenden, um den URI eines externen Datenträgerspeicherorts außerhalb des MSIX-Pakets anzugeben, in dem das Paketmanifest auf Anwendungsinhalt verweisen kann. Weitere Informationen zu diesem Szenario und einem zugehörigen Codebeispiel finden Sie unter Gewähren der Paketidentität durch Packen mit externem Speicherort.
Sie können die AllowUnsigned-Eigenschaft des Optionsparameters verwenden, um Aktivierungsinformationen aus einer ausführbaren Datei in einem nicht signierten Paket zuzulassen. Weitere Informationen zu diesem Szenario und ein zugehöriges Codebeispiel finden Sie unter Gehostete Apps.