Menyertakan file data dalam aplikasi ClickOnce

Setiap aplikasi ClickOnce yang Anda instal diberi direktori data pada disk lokal komputer tujuan tempat aplikasi dapat mengelola datanya sendiri. File data dapat menyertakan file dengan jenis apa pun: file teks, file XML, atau bahkan file database Microsoft Access (.mdb). Prosedur berikut menunjukkan kepada Anda cara menambahkan file data dengan jenis apa pun ke dalam aplikasi ClickOnce Anda.

Catatan

Di ClickOnce untuk .NET Core 3.1 dan .NET 5 atau yang lebih baru, gunakan dotnet-mage.exe alih-alih Mage.exe. Untuk informasi selengkapnya, lihat ClickOnce untuk .NET.

Untuk menyertakan file data dengan menggunakan Mage.exe

1. Tambahkan file data ke direktori aplikasi Anda dengan file aplikasi Anda lainnya.

   Biasanya, direktori aplikasi Anda akan menjadi direktori yang diberi label dengan versi penyebaran saat ini—misalnya, v1.0.0.0.

2. Perbarui manifes aplikasi Anda untuk mencantumkan file data.

   mage -u v1.0.0.0\Application.manifest -FromDirectory v1.0.0.0

   Melakukan tugas ini membuat ulang daftar file dalam manifes aplikasi Anda dan juga secara otomatis menghasilkan tanda tangan hash.

3. Buka manifes aplikasi di teks atau editor XML pilihan Anda dan temukan elemen file untuk file yang baru ditambahkan.

   Jika Anda menambahkan file XML bernama Data.xml, file akan terlihat mirip dengan contoh kode berikut.

   <file name="Data.xml" hash="23454C18A2DC1D23E5B391FEE299B1F235067C59" hashalg="SHA1" asmv2:size="39500" />

4. Tambahkan atribut type ke elemen ini, dan beri nilai data.

   <file name="Data.xml" writeableType="applicationData" hash="23454C18A2DC1D23E5B391FEE299B1F235067C59" hashalg="SHA1" asmv2:size="39500" />

5. Tanda tangani kembali manifes aplikasi Anda dengan menggunakan pasangan kunci atau sertifikat Anda, lalu tanda tangani kembali manifes penyebaran Anda.

   Anda harus menandatangani ulang manifes penyebaran karena hash manifes aplikasi telah berubah.

   mage -s app manifest -cf cert_file -pwd password

   mage -u deployment manifest -appm app manifest

   mage -s deployment manifest -cf certfile -pwd password

Untuk menyertakan file data dengan menggunakan MageUI.exe

1. Tambahkan file data ke direktori aplikasi Anda dengan file aplikasi Anda lainnya.

2. Biasanya, direktori aplikasi Anda akan menjadi direktori yang diberi label dengan versi penyebaran saat ini—misalnya, v1.0.0.0.

3. Pada menu File, klik Buka untuk membuka manifes aplikasi Anda.

4. Pilih tab File.

5. Dalam kotak teks di bagian atas tab, masukkan direktori yang berisi file aplikasi Anda, lalu klik Isi.

   File data Anda akan muncul di kisi.

6. Atur nilai Jenis File dari file data ke Data.

7. Simpan manifes aplikasi, lalu tanda tangani ulang file.

   MageUI.exe akan meminta Anda untuk menandatangani ulang file.

8. Menandatangani ulang manifes penyebaran Anda

   Anda harus menandatangani ulang manifes penyebaran karena hash manifes aplikasi telah berubah.

Konten terkait

• Mengakses data lokal dan jarak jauh dalam aplikasi ClickOnce