Package.GetAppInstallerInfo Metode

Referensi

Definisi

Ruang nama:: Windows.ApplicationModel

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Edit

Mengembalikan lokasi file XML .appinstaller. Gunakan metode ini saat Anda perlu mengambil lokasi file XML .appinstaller untuk aplikasi Anda. Misalnya, ini berguna jika aplikasi Anda perlu berbagi URI ke file .appinstaller terkait. Anda dapat secara opsional menambahkan argumen ke URI.

public:
 virtual AppInstallerInfo ^ GetAppInstallerInfo() = GetAppInstallerInfo;

AppInstallerInfo GetAppInstallerInfo();

public AppInstallerInfo GetAppInstallerInfo();

function getAppInstallerInfo()

Public Function GetAppInstallerInfo () As AppInstallerInfo

Mengembalikan

AppInstallerInfo

Lokasi file XML .appinstaller.

Persyaratan Windows

Rangkaian perangkat	Windows 10, version 1809 (diperkenalkan dalam 10.0.17763.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v7.0)

Contoh

Contoh berikut menghasilkan URI .appinstaller dengan argumen dan membuat email untuk mengirim URI ke pengguna lain. Dalam contoh ini, ComposeEmailAsync metode diasumsikan didefinisikan di tempat lain.

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

Keterangan

Gunakan metode ini jika Anda ingin mendapatkan URI ke file .appinstaller yang terkait dengan aplikasi saat ini sehingga Anda dapat berbagi URI dengan pengguna. Jika pengguna yang tidak memiliki aplikasi mengklik URI, mereka diambil melalui proses penginstalan untuk aplikasi. Jika pengguna yang sudah memiliki aplikasi mengeklik URI, aplikasi diperbarui jika diperlukan, lalu aplikasi akan terbuka.

Anda dapat secara opsional menambahkan argumen ke URI. Dalam hal ini, perilakunya sama seperti yang dijelaskan di atas, tetapi aplikasi kemudian dapat menggunakan argumen saat terbuka. Argumen harus menggunakan protokol yang didukung aplikasi. Untuk informasi selengkapnya, lihat Menangani aktivasi URI.

Berlaku untuk