Поделиться через


Package.GetAppInstallerInfo Метод

Определение

Возвращает расположение XML-файла APPINSTALLER. Используйте этот метод, если необходимо получить расположение XML-файла appinstaller для приложения. Например, это полезно, если приложению необходимо предоставить общий доступ к универсальному коду ресурса (URI) в связанный с ним файл .appinstaller. При необходимости можно добавить аргументы в URI.

public:
 virtual AppInstallerInfo ^ GetAppInstallerInfo() = GetAppInstallerInfo;
AppInstallerInfo GetAppInstallerInfo();
public AppInstallerInfo GetAppInstallerInfo();
function getAppInstallerInfo()
Public Function GetAppInstallerInfo () As AppInstallerInfo

Возвращаемое значение

Расположение XML-файла APPINSTALLER.

Требования к Windows

Семейство устройств
Windows 10, version 1809 (появилось в 10.0.17763.0)
API contract
Windows.Foundation.UniversalApiContract (появилось в v7.0)

Примеры

В следующем примере создается URI appinstaller с аргументами и создается сообщение электронной почты для отправки URI другому пользователю. В этом примере предполагается, ComposeEmailAsync что метод определен в другом месте.

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

Комментарии

Используйте этот метод, если вы хотите получить универсальный код ресурса (URI) в appinstaller-файл, связанный с текущим приложением, чтобы предоставить пользователям общий доступ к URI. Если пользователь, у которого нет приложения, щелкает универсальный код ресурса (URI), он проходит через процесс установки приложения. Если пользователь, у которого уже есть приложение, щелкает универсальный код ресурса (URI), приложение при необходимости обновляется, а затем открывается.

При необходимости можно добавить аргументы в URI. В этом случае поведение будет таким же, как описано выше, но приложение может использовать аргументы при открытии. Аргументы должны использовать протокол, поддерживаемый приложением. Дополнительные сведения см. в разделе Обработка активации URI.

Применяется к

См. также раздел