Package.GetAppInstallerInfo Methode

Definition

Namespace:

Windows.ApplicationModel

Gibt den SPEICHERORT der XML-Datei .appinstaller zurück. Verwenden Sie diese Methode, wenn Sie den XML-Dateispeicherort .appinstaller für Ihre App abrufen müssen. Dies ist beispielsweise nützlich, wenn Ihre App einen URI für die zugeordnete APPINSTALLER-Datei freigeben muss. Sie können dem URI optional Argumente hinzufügen.

public:
 virtual AppInstallerInfo ^ GetAppInstallerInfo() = GetAppInstallerInfo;

AppInstallerInfo GetAppInstallerInfo();

public AppInstallerInfo GetAppInstallerInfo();

function getAppInstallerInfo()

Public Function GetAppInstallerInfo () As AppInstallerInfo

Gibt zurück

AppInstallerInfo

Der SPEICHERORT der XML-Datei .appinstaller.

Windows-Anforderungen

Gerätefamilie	Windows 10, version 1809 (eingeführt in 10.0.17763.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v7.0)

Beispiele

Im folgenden Beispiel wird ein APPINSTALLER-URI mit Argumenten generiert und eine E-Mail erstellt, um den URI an einen anderen Benutzer zu senden. In diesem Beispiel wird davon ausgegangen, dass die ComposeEmailAsync -Methode an anderer Stelle definiert ist.

AppInstallerInfo info = Windows.ApplicationModel.Package.Current.GetAppInstallerInfo();
if (info != null)
{
    // Uri that was used to install the app.
    // Example: http://contoso/connect4.appinstaller.
    Uri appInstallerUri = info.Uri;

    // Create the inner URI which uses a protocol handled by your app, passing any arguments needed in it 
    UriBuilder innerUriBuilder = new UriBuilder("my-app-protocol:");
    innerUriBuilder.Query = "difficulty=hard&highscore=9000";

    // Create outer URI builder for ms-appinstaller initializer link.
    UriBuilder outerUriBuilder = new UriBuilder("ms-appinstaller:");
    outerUriBuilder.Query =
        $"source={Uri.EscapeDataString(appInstallerUri.ToString())}&activationUri={Uri.EscapeDataString(innerUriBuilder.ToString())}";

    await ComposeEmailAsync(/* To */ colleagueEmail, /* Subject */ "Beat my high score!",
        /* Body */ outerUriBuilder.ToString());
}

Hinweise

Verwenden Sie diese Methode, wenn Sie den URI der appinstaller-Datei abrufen möchten, die der aktuellen App zugeordnet ist, damit Sie den URI für Benutzer freigeben können. Wenn ein Benutzer, der nicht über die App verfügt, auf den URI klickt, wird er durch den Installationsvorgang für die App geleitet. Wenn ein Benutzer, der bereits über die App verfügt, auf den URI klickt, wird die App bei Bedarf aktualisiert und dann geöffnet.

Sie können dem URI optional Argumente hinzufügen. In diesem Fall entspricht das Verhalten dem oben beschriebenen, aber die App kann dann die Argumente verwenden, wenn sie geöffnet wird. Die Argumente müssen ein Protokoll verwenden, das von der App unterstützt wird. Weitere Informationen finden Sie unter Behandeln der URI-Aktivierung.

Weitere Informationen

• Uri
• APP-Installer-APIs
• Behandeln der URI-Aktivierung