Elemen <entryPoint> (aplikasi ClickOnce)
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>