Package.GetAppInstallerInfo Méthode

Référence

Définition

Espace de noms:: Windows.ApplicationModel

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

Retourne l’emplacement du fichier XML .appinstaller. Utilisez cette méthode lorsque vous devez récupérer l’emplacement du fichier XML .appinstaller pour votre application. Par exemple, cela est utile si votre application doit partager un URI vers son fichier .appinstaller associé. Vous pouvez éventuellement ajouter des arguments à l’URI.

public:
 virtual AppInstallerInfo ^ GetAppInstallerInfo() = GetAppInstallerInfo;

AppInstallerInfo GetAppInstallerInfo();

public AppInstallerInfo GetAppInstallerInfo();

function getAppInstallerInfo()

Public Function GetAppInstallerInfo () As AppInstallerInfo

Retours

AppInstallerInfo

Emplacement du fichier XML .appinstaller.

Configuration requise pour Windows

Famille d’appareils	Windows 10, version 1809 (introduit dans 10.0.17763.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v7.0)

Exemples

L’exemple suivant génère un URI .appinstaller avec des arguments et crée un e-mail pour envoyer l’URI à un autre utilisateur. Dans cet exemple, la ComposeEmailAsync méthode est supposée être définie ailleurs.

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());
}

Remarques

Utilisez cette méthode si vous souhaitez obtenir l’URI du fichier .appinstaller associé à l’application actuelle afin de pouvoir partager l’URI avec les utilisateurs. Si un utilisateur qui n’a pas l’application clique sur l’URI, il passe par le processus d’installation de l’application. Si un utilisateur qui a déjà l’application clique sur l’URI, l’application est mise à jour si nécessaire, puis s’ouvre.

Vous pouvez éventuellement ajouter des arguments à l’URI. Dans ce cas, le comportement est le même que celui décrit ci-dessus, mais l’application peut ensuite utiliser les arguments lorsqu’elle s’ouvre. Les arguments doivent utiliser un protocole pris en charge par l’application. Pour plus d’informations, consultez Gérer l’activation d’URI.

S’applique à