Package.GetAppInstallerInfo Metodo

Definizione

Spazio dei nomi:

Windows.ApplicationModel

Restituisce il percorso del file XML con estensione appinstaller. Usare questo metodo quando è necessario recuperare il percorso del file XML con estensione appinstaller per l'app. Ad esempio, questo è utile se l'app deve condividere un URI al file con estensione appinstaller associato. Facoltativamente, è possibile aggiungere argomenti all'URI.

public:
 virtual AppInstallerInfo ^ GetAppInstallerInfo() = GetAppInstallerInfo;

AppInstallerInfo GetAppInstallerInfo();

public AppInstallerInfo GetAppInstallerInfo();

function getAppInstallerInfo()

Public Function GetAppInstallerInfo () As AppInstallerInfo

Restituisce

AppInstallerInfo

Percorso del file XML con estensione appinstaller.

Requisiti Windows

Famiglia di dispositivi	Windows 10, version 1809 (è stato introdotto in 10.0.17763.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v7.0)

Esempio

L'esempio seguente genera un URI .appinstaller con argomenti e crea un messaggio di posta elettronica per inviare l'URI a un altro utente. In questo esempio si presuppone che il ComposeEmailAsync metodo sia definito altrove.

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

Commenti

Usa questo metodo se vuoi ottenere l'URI al file con estensione appinstaller associato all'app corrente in modo da poter condividere l'URI con gli utenti. Se un utente che non ha l'app fa clic sull'URI, viene eseguito tramite il processo di installazione per l'app. Se un utente che ha già l'app fa clic sull'URI, l'app viene aggiornata se necessario e quindi viene aperta.

Facoltativamente, è possibile aggiungere argomenti all'URI. In questo caso, il comportamento è identico a quello descritto in precedenza, ma l'app può quindi usare gli argomenti all'apertura. Gli argomenti devono usare un protocollo supportato dall'app. Per altre informazioni, vedere Gestire l'attivazione dell'URI.

Vedi anche

• Uri
• API del programma di installazione app
• Gestire l'attivazione di URI