uap:Protocol (Windows 10)

  • Artikel

Mendeklarasikan titik ekstensibilitas aplikasi jenis windows.protocol. Asosiasi URI menunjukkan bahwa aplikasi terdaftar untuk menangani URI dengan skema yang ditentukan.

Hierarki elemen

<Paket>

    <Aplikasi>

         <Aplikasi>

              <Ekstensi>

                   <uap:Extension>

                        <uap:Protocol>

Sintaks

<uap:Protocol
  Name = 'A string with a value between 2 and 39 characters in length that contains numbers, lowercase letters, periods ("."), plus signs ("+"), or dashes ("-"). The string cannot start with a period (".").'
  DesiredView = 'A string that can have one of the following values: "default", "useLess", "useHalf", "useMore", or "useMinimum".'
  ReturnResults = 'An optional string that can have one of the following values: "none", "always", "optional".' >

  <!-- Child elements -->
  uap:Logo?
  & uap:DisplayName?
  & desktop7:ProgId
</uap:Protocol>

Kunci

? opsional (nol atau satu) & konektor interleave (dapat terjadi dalam urutan apa pun)

Atribut dan elemen

Atribut

Atribut Deskripsi Jenis Data Diperlukan Nilai default
Nama Nama skema URI (seperti mailto). Nama ini harus unik untuk paket. String dengan panjang nilai antara 2 dan 39 karakter yang berisi angka, huruf kecil, titik (.), tanda plus (+), atau tanda hubung (-). String tidak dapat dimulai dengan titik (.). Ya
DesiredView Jumlah ruang layar yang diinginkan untuk digunakan saat janji temu diluncurkan. String yang dapat memiliki salah satu nilai berikut: default, useLess, useHalf, useMore, atau useMinimum. Tidak
ReturnResults Menentukan apakah aplikasi mengembalikan nilai saat dipanggil melalui aktivasi URI. String opsional yang dapat memiliki salah satu nilai berikut: "none" (tidak mengembalikan nilai), "always" (aktivasi URI akan selalu mengembalikan hasil), "opsional" (aktivasi URI akan mengembalikan hasil jika diaktifkan untuk hasil menggunakan LaunchUriForResultsAndContinueAsync). Tidak

Elemen anak

elemen anak Deskripsi
uap:DisplayName Nama yang mudah diingat yang dapat ditampilkan kepada pengguna.
uap:Logo Jalur ke file yang berisi gambar.
desktop7:ProgId Pengidentifikasi terprogram (ProgID) yang dapat dikaitkan dengan CLSID.

Elemen induk

elemen induk Deskripsi
uap:Extension Mendeklarasikan titik ekstensibilitas untuk aplikasi.

Contoh

Contoh berikut diambil dari manifes paket salah satu sampel SDK.

<Applications>
  <Application
    Id="App"
    StartPage="default.html">
    <Extensions>
      <uap:Extension
        Category="windows.protocol">
        <uap:Protocol
          Name="alsdk" />
      </uap:Extension>
    </Extensions>
  </Application>
</Applications>

Lihat juga

TugasCara menangani aktivasi URI

KonsepKontrak dan ekstensi Aplikasi

Persyaratan

Item Nilai
Ruang nama http://schemas.microsoft.com/appx/manifest/uap/windows10
Versi OS Minimum Windows 10 versi 1511 (Build 10586)