PackageManager.RequestAddPackageAsync 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.
Überlädt
RequestAddPackageAsync(Uri, IIterable<Uri>, DeploymentOptions, PackageVolume, IIterable<String>, IIterable<Uri>, IIterable<Uri>) |
Fordert eine SmartScreen-Überprüfung und Benutzerüberprüfung vor der Installation der App-Pakete an. Diese Methode stellt eine packageUrisToInstall-Überladung bereit, um externe Pakete anzugeben, die bereitgestellt und registriert werden sollen. |
RequestAddPackageAsync(Uri, IIterable<Uri>, DeploymentOptions, PackageVolume, IIterable<String>, IIterable<Uri>) |
Fordert eine SmartScreen-Überprüfung und Benutzerüberprüfung vor der Installation der App-Pakete an. |
RequestAddPackageAsync(Uri, IIterable<Uri>, DeploymentOptions, PackageVolume, IIterable<String>, IIterable<Uri>, IIterable<Uri>)
Fordert eine SmartScreen-Überprüfung und Benutzerüberprüfung vor der Installation der App-Pakete an. Diese Methode stellt eine packageUrisToInstall-Überladung bereit, um externe Pakete anzugeben, die bereitgestellt und registriert werden sollen.
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)
Parameter
Der URI des hinzuzufügenden Pakets. Der URI muss dem Datei-URI-Schema (file://) folgen, da die einzigen unterstützten URI-Schemas lokale Dateipfade und lokale Netzwerkpfade sind.
- dependencyPackageUris
Die URIs der hinzuzufügenden Abhängigkeitspakete. Wenn keine Abhängigkeitspakete vorhanden sind oder die Abhängigkeitspakete bereits registriert sind, kann dieser Parameter NULL sein.
- deploymentOptions
- DeploymentOptions
Ein gültiger Enumerationswert aus der DeploymentOptions-Enumeration .
- targetVolume
- PackageVolume
Das Volume, auf dem das Paket installiert ist.
Zeichenfolgen, die die optionalen Paketfamiliennamen aus dem Standard Bundle angeben, das bereitgestellt und registriert werden soll.
- relatedPackageUris
Die URIs zusätzlicher Pakete im Standard Bundles, die bereitgestellt und registriert werden sollen.
- packageUrisToInstall
Eine Liste mit anderen Paket-URIs, die bereitgestellt und registriert werden sollen. Dies kann Pfade zu externen Paketen enthalten, die installiert werden sollen.
Gibt zurück
Der Fortschritt und das Ergebnis des Hinzufügens des App-Pakets.
- Attribute
Windows-Anforderungen
Gerätefamilie |
Windows 10, version 1803 (eingeführt in 10.0.17134.0)
|
API contract |
Windows.Foundation.UniversalApiContract (eingeführt in v6.0)
|
Weitere Informationen
Gilt für:
RequestAddPackageAsync(Uri, IIterable<Uri>, DeploymentOptions, PackageVolume, IIterable<String>, IIterable<Uri>)
Fordert eine SmartScreen-Überprüfung und Benutzerüberprüfung vor der Installation der App-Pakete an.
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)
Parameter
Der URI des hinzuzufügenden Pakets. Der URI muss dem Datei-URI-Schema (file://) folgen, da die einzigen unterstützten URI-Schemas lokale Dateipfade und lokale Netzwerkpfade sind.
- dependencyPackageUris
Die URIs der hinzuzufügenden Abhängigkeitspakete. Wenn keine Abhängigkeitspakete vorhanden sind oder die Abhängigkeitspakete bereits registriert sind, kann dieser Parameter NULL sein.
- deploymentOptions
- DeploymentOptions
Ein gültiger Enumerationswert aus der DeploymentOptions-Enumeration .
- targetVolume
- PackageVolume
Das Volume, auf dem das Paket installiert ist.
Zeichenfolgen, die die optionalen Paketfamiliennamen aus dem Standard Bundle angeben, das bereitgestellt und registriert werden soll.
- relatedPackageUris
Die URIs zusätzlicher Pakete im Standard Bundles, die bereitgestellt und registriert werden sollen.
Gibt zurück
Der Fortschritt und das Ergebnis der Bereitstellung des App-Pakets.
- Attribute
Windows-Anforderungen
Gerätefamilie |
Windows 10 Fall Creators Update (eingeführt in 10.0.16299.0)
|
API contract |
Windows.Foundation.UniversalApiContract (eingeführt in v5.0)
|
Beispiele
Das Beispiel veranschaulicht, wie RequestAddPackageAsync in einer UWP-App verwendet wird, indem sie mit einem Klickhandler für Schaltflächen eingebunden wird. Dadurch wird das Fenster der SmartScreen-Anforderungsbenutzeroberfläche aufgerufen.
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.
}
}
}