Bagikan melalui

Ekstensi (dalam jenis: CT_ApplicationExtensions)

  • Artikel

Mendeklarasikan titik ekstensibilitas untuk aplikasi.

Hierarki elemen

<Paket>
<Aplikasi>
<Aplikasi>
<Ekstensi>
<Ekstensi>

Sintaks

<Extension Category     = "windows.fileTypeAssociation" | "windows.protocol" | "windows.autoPlayContent" | "windows.autoPlayDevice" | "windows.shareTarget" | ...
           Executable?  = A string between 1 and 256 characters in length that must end with ".exe" and cannot contain these characters: <, >, :, %, ", |, ?, or *. It specifies the default executable for the extension. If not specified, the executable defined for the app is used.  If specified, the EntryPoint property is also used. If that EntryPoint property isn't specified, the EntryPoint defined for the app is used.
           EntryPoint?  = A string between 1 and 256 characters in length, representing the task  handling the extension. This is normally the fully namespace-qualified name of a Windows Runtime type.
If EntryPoint is not specified, the EntryPoint defined for the app is used instead.

           RuntimeType? = A string between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, %, ", /, \, |, ?, or *.
           StartPage?   = A string between 1 and 256 characters in length that cannot contain these characters: <, >, :, %, ", |, ?, or *. >

  <!-- Child elements -->
  ( FileTypeAssociation
  | Protocol
  | AutoPlayContent
  | AutoPlayDevice
  | ShareTarget
  | FileOpenPicker
  | FileSavePicker
  | BackgroundTasks
  )?

</Extension>

Kunci

? opsional (nol atau satu)

Atribut dan Elemen

Atribut

Atribut Deskripsi Jenis Data Diperlukan Nilai default
Kategori

Jenis titik ekstensibilitas aplikasi.

Atribut ini dapat memiliki salah satu nilai berikut:

  • windows.fileTypeAssociation
  • windows.protocol
  • windows.autoPlayContent
  • windows.autoPlayDevice
  • windows.shareTarget
  • windows.search
  • windows.fileOpenPicker
  • windows.fileSavePicker
  • windows.cachedFileUpdater
  • windows.contactPicker
  • windows.backgroundTasks
  • windows.cameraSettings
  • windows.accountPictureProvider
  • windows.printTaskSettings
 Ya
EntryPoint

ID kelas yang dapat diaktifkan.

 Panjang string antara 1 dan 256 karakter, mewakili tugas yang menangani ekstensi. Ini biasanya merupakan nama yang sepenuhnya memenuhi syarat namespace dari jenis Windows Runtime. Jika EntryPoint tidak ditentukan, EntryPoint yang ditentukan untuk aplikasi akan digunakan sebagai gantinya. Tidak
Eksekusi

Peluncuran default yang dapat dieksekusi.

 Panjang string antara 1 dan 256 karakter yang harus diakhbungi dengan ".exe" dan tidak boleh berisi karakter ini: <, , >:, %, ", |, ?, atau *. Ini menentukan executable default untuk ekstensi. Jika tidak ditentukan, executable yang ditentukan untuk aplikasi akan digunakan. Jika ditentukan, properti EntryPoint juga digunakan. Jika properti EntryPoint tersebut tidak ditentukan, EntryPoint yang ditentukan untuk aplikasi akan digunakan. Tidak
RuntimeType

Penyedia runtime. Atribut ini biasanya digunakan ketika ada kerangka kerja campuran dalam aplikasi.

 Panjang string antara 1 dan 255 karakter yang tidak dapat dimulai atau diakhbungi dengan titik atau berisi karakter ini: <, , >:, %, ", /, \, |, ?, atau *. Tidak
StartPage

Halaman web yang menangani titik ekstensibilitas.

 Panjang string antara 1 dan 256 karakter yang tidak boleh berisi karakter ini: <, , >:, %, ", |, ?, atau *. Tidak

 

Elemen Anak

Elemen Anak Deskripsi
AutoPlayContent

Mendeklarasikan titik ekstensibilitas aplikasi jenis windows.autoPlayContent. Aplikasi ini menyediakan tindakan konten AutoPlay yang ditentukan.
AutoPlayDevice

Mendeklarasikan titik ekstensibilitas aplikasi jenis windows.autoPlayDevice. Aplikasi ini menyediakan tindakan perangkat AutoPlay yang ditentukan.
BackgroundTasks

Menentukan titik ekstensibilitas aplikasi jenis windows.backgroundTasks. Tugas latar belakang berjalan di host latar belakang khusus; yaitu, tanpa UI.
FileOpenPicker

Mendeklarasikan titik ekstensibilitas aplikasi jenis windows.fileOpenPicker. Aplikasi ini memungkinkan pengguna memilih dan membuka jenis file yang ditentukan.
FileSavePicker

Mendeklarasikan titik ekstensibilitas aplikasi jenis windows.fileSavePicker. Aplikasi ini memungkinkan pengguna memilih nama file, ekstensi, dan lokasi penyimpanan untuk jenis file yang ditentukan.
FileTypeAssociation

Mendeklarasikan titik ekstensibilitas aplikasi jenis windows.fileTypeAssociation. Asosiasi jenis file menunjukkan bahwa aplikasi terdaftar untuk menangani file dari jenis yang ditentukan.
Protokol

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

Mendeklarasikan titik ekstensi aplikasi jenis windows.shareTarget. Aplikasi ini dapat berbagi jenis file yang ditentukan.

 

Elemen Induk

Elemen Induk Deskripsi
Ekstensi (jenis: CT_ApplicationExtensions)

Menentukan satu atau beberapa titik ekstensibilitas untuk aplikasi.

 

Elemen berikut memiliki nama yang sama dengan yang satu ini, tetapi konten atau atribut yang berbeda:

Keterangan

Titik ekstensibilitas ini hanya dapat dideklarasikan sekali per aplikasi:

  • windows.accountPictureProvider
  • windows.cachedFileUpdater
  • windows.cameraSettings
  • windows.contactPicker
  • windows.fileOpenPicker
  • windows.fileSavePicker
  • windows.printTaskSettings
  • windows.search
  • windows.shareTarget

**Catatan tentang aturan semantik untuk ekstensi: **Untuk elemen Ekstensi apa pun, aturan semantik berikut diberlakukan dalam API manifes:

Jika /Application/@StartPage ditentukan, ini adalah aplikasi Windows menggunakan JavaScript dan Ekstensi Aplikasi :

  • Bisa kosong
  • Hanya dapat menentukan StartPage
  • Dapat menentukan Executable dan EntryPoint (RuntimeType opsional diizinkan), kecuali jika itu adalah ekstensi BackgroundTask, dalam hal ini dapat menghilangkan Executable dan default ke BackgroundTaskHost.exe dapat dieksekusi.

Jika /Application/@StartPage tidak ditentukan, ini adalah aplikasi UWP menggunakan C# atau VB dan XAML dan Ekstensi Aplikasi :

  • Bisa kosong
  • Hanya dapat menentukan StartPage
  • Harus menentukan EntryPoint jika Executable atau RuntimeType ditentukan.

Contoh

Contoh berikut diambil dari manifes paket salah satu sampel SDK.

<Applications>
  <Application Id="App" StartPage="default.html">
    <VisualElements DisplayName="Assocation launching sample" 
         Logo="images\squareTile-sdk.png" SmallLogo="images\smallTile-sdk.png" 
         Description="SDK sample" 
         ForegroundText="dark" BackgroundColor="#FFFFFF" ToastCapable="false">
      <DefaultTile ShowName="allLogos" />
      <SplashScreen BackgroundColor="white" Image="images\splash-sdk.png" />
    </VisualElements>
    <Extensions>
      <Extension Category="windows.fileTypeAssociation">
        <FileTypeAssociation Name=".alsdkjs">
          <SupportedFileTypes>
            <FileType>.alsdkjs</FileType>
          </SupportedFileTypes>
        </FileTypeAssociation>
      </Extension>
      <Extension Category="windows.protocol">
        <Protocol Name="alsdkjs" />
      </Extension>
    </Extensions>
  </Application>
</Applications>

Lihat juga

KonsepKontrak dan ekstensi Aplikasi

Persyaratan

Nilai
Ruang nama http://schemas.microsoft.com/appx/2010/manifest