Freigeben über


PackageManager.RequestAddPackageAsync Methode

Definition

Ü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

packageUri
Uri Uri

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

IIterable<Uri>

IEnumerable<Uri>

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.

optionalPackageFamilyNames

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

Zeichenfolgen, die die optionalen Paketfamiliennamen aus dem Standard Bundle angeben, das bereitgestellt und registriert werden soll.

relatedPackageUris

IIterable<Uri>

IEnumerable<Uri>

Die URIs zusätzlicher Pakete im Standard Bundles, die bereitgestellt und registriert werden sollen.

packageUrisToInstall

IIterable<Uri>

IEnumerable<Uri>

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

packageUri
Uri Uri

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

IIterable<Uri>

IEnumerable<Uri>

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.

optionalPackageFamilyNames

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

Zeichenfolgen, die die optionalen Paketfamiliennamen aus dem Standard Bundle angeben, das bereitgestellt und registriert werden soll.

relatedPackageUris

IIterable<Uri>

IEnumerable<Uri>

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.
        }
    }
}

Weitere Informationen

Gilt für: