Elemen <entryPoint> (aplikasi ClickOnce)

Artikel
10/10/2023

Mengidentifikasi rakitan yang harus dijalankan ketika aplikasi ClickOnce ini berjalan pada komputer klien.

Sintaks

<entryPoint
   name
>
   <assemblyIdentity
      name
      version
      processorArchitecture
      language
   />
   <commandLine
      file
      parameters
   />
   <customHostRequired />
   <customUX />
</entryPoint>

Elemen dan atribut

Elemen entryPoint diperlukan dan berada di namespace layanan urn:schemas-microsoft-com:asm.v2. Mungkin hanya ada satu elemen entryPoint yang ditentukan dalam manifes aplikasi.

Elemen entryPoint memiliki atribut berikut.

Atribut	Deskripsi
`name`	Opsional. Nilai ini tidak digunakan oleh .NET Framework.

entryPoint memiliki elemen-elemen berikut.

assemblyIdentity

Harus diisi. Peran assemblyIdentity dan atributnya didefinisikan dalam Elemen <assemblyIdentity>.

Atribut elemen processorArchitecture dan atribut processorArchitecture yang ditentukan di tempat selain assemblyIdentity dalam manifes aplikasi harus cocok.

commandLine

Harus diisi. Harus merupakan turunan dari elemen entryPoint. Ini tidak memiliki elemen turunan dan memiliki atribut berikut.

Atribut	Deskripsi
`file`	Harus diisi. Referensi lokal ke rakitan startup untuk aplikasi ClickOnce. Nilai ini tidak boleh berisi pemisah jalur garis miring (/) atau garis miring ke belakarang (\).
`parameters`	Harus diisi. Menjelaskan tindakan yang harus diambil dengan titik masuk. Satu-satunya nilai yang valid adalah `run`; jika string kosong disediakan, `run` diasumsikan.

customHostRequired

Opsional. Jika disertakan, menentukan bahwa penyebaran ini berisi komponen yang akan disebarkan di dalam host kustom, dan bukan aplikasi yang berdiri sendiri.

Jika elemen ini ada, elemen assemblyIdentity dan commandLine tidak boleh ada. Jika sudah, ClickOnce akan menimbulkan kesalahan validasi selama penginstalan.

Elemen ini tidak memiliki atribut dan tidak ada turunan.

customUX

Opsional. Menentukan bahwa aplikasi diinstal dan dikelola oleh penginstal kustom, dan tidak membuat entri menu Mulai, pintasan, atau entri Tambah atau Hapus Program.

<customUX xmlns="urn:schemas-microsoft-com:clickonce.v1" />

Aplikasi yang menyertakan elemen customUX harus menyediakan alat penginstal kustom yang menggunakan kelas InPlaceHostingManager untuk melakukan operasi penginstalan. Aplikasi dengan elemen ini tidak dapat diinstal dengan mengeklik dua kali manifesnya atau bootstrapper prasyarat setup.exe. Penginstal kustom dapat membuat entri menu Mulai, pintasan, dan entri Tambah atau Hapus Program. Jika penginstal kustom tidak membuat entri Tambahkan atau Hapus Program, pengidentifikasi langganan harus disimpan oleh properti SubscriptionIdentity dan memungkinkan pengguna untuk menghapus instalan aplikasi nanti dengan memanggil metode UninstallCustomUXApplication. Untuk informasi selengkapnya, lihat Panduan: Membuat Penginstal Kustom untuk Aplikasi ClickOnce.

Keterangan

Elemen ini mengidentifikasi rakitan dan titik masuk untuk aplikasi ClickOnce.

Anda tidak dapat menggunakan commandLine untuk meneruskan parameter ke aplikasi Anda pada saat runtime. Anda dapat mengakses parameter string kueri untuk penyebaran ClickOnce dari AppDomain aplikasi. Untuk informasi selengkapnya, lihat Cara: Mengambil Informasi String Kueri dalam Aplikasi ClickOnce Online.

Contoh

Contoh kode berikut mengilustrasikan elemen entryPoint dalam manifes aplikasi untuk aplikasi ClickOnce. Contoh kode ini adalah bagian dari contoh besar yang disediakan untuk topik Manifes Aplikasi ClickOnce.

<!-- Identify the main code entrypoint. -->
<!-- This code runs the main method in an executable assembly. -->
  <entryPoint>
    <assemblyIdentity
      name="MyApplication"
      version="1.0.0.0"
      language="neutral"
      processorArchitecture="x86" />
    <commandLine file="MyApplication.exe" parameters="" />
  </entryPoint>

Bagikan melalui