<file> elemen (aplikasi ClickOnce)
Mengidentifikasi semua file non-rakitan yang diunduh dan digunakan oleh aplikasi.
Sintaks
<file
name
size
group
optional
writeableType
>
<typelib
tlbid
version
helpdir
resourceid
flags
/>
<comClass
clsid
description
threadingModel
tlbid
progid
miscStatus
miscStatusIcon
miscStatusContent
miscStatusDocPrint
miscStatusThumbnail
/>
<comInterfaceExternalProxyStub
iid
baseInterface
numMethods
name
tlbid
proxyStubClass32
/>
<comInterfaceProxyStub
iid
baseInterface
numMethods
name
tlbid
proxyStubClass32
/>
<windowClass
versioned
/>
</file>
Elemen dan atribut
Elemen file
adalah opsional. Elemen ini memiliki atribut berikut.
Atribut | Deskripsi |
---|---|
name |
Harus diisi. Mengidentifikasi nama file. |
size |
Harus diisi. Menentukan ukuran file dalam byte. |
group |
Opsional, jika atribut optional tidak ditentukan atau diatur ke false ; diperlukan jika optional adalah true . Nama grup tempat file ini berada. Nama dapat berupa nilai string Unicode apa pun yang dipilih oleh pengembang, dan digunakan untuk mengunduh file sesuai permintaan dengan kelas ApplicationDeployment. |
optional |
Opsional. Menentukan apakah file ini harus diunduh ketika aplikasi pertama kali dijalankan, atau apakah file harus hanya berada di server sampai aplikasi memintanya sesuai permintaan. Jika false atau tidak ditentukan, file diunduh saat aplikasi pertama kali dijalankan atau diinstal. Jika true , group harus ditentukan agar manifes aplikasi valid. optional tidak boleh true jika writeableType ditentukan dengan nilai applicationData . |
writeableType |
Opsional. Menentukan bahwa file ini adalah file data. Satu-satunya nilai yang valid saat ini adalah applicationData . |
typelib
Elemen typelib
adalah turunan opsional dari elemen file. Elemen tersebut menjelaskan pustaka jenis milik komponen COM. Elemen ini memiliki atribut berikut.
Atribut | Deskripsi |
---|---|
tlbid |
Harus diisi. GUID yang ditetapkan ke pustaka jenis. |
version |
Harus diisi. Nomor versi pustaka jenis. |
helpdir |
Harus diisi. Direktori yang berisi file Bantuan untuk komponen. Mungkin kosong. |
resourceid |
Opsional. Representasi string heksadesimal dari pengidentifikasi lokal (LCID). Ini berupa satu hingga empat digit heksadesimal tanpa awalan 0x dan tanpa nol di depan. LCID mungkin memiliki pengidentifikasi subbahasa netral. |
flags |
Opsional. Representasi string dari bendera pustaka jenis untuk pustaka jenis ini. Secara khusus, ini harus menjadi salah satu dari "RESTRICTED", "CONTROL", "HIDDEN" dan "HASDISKIMAGE". |
comClass
Elemen comClass
adalah turunan opsional dari elemen file
, tetapi diperlukan jika aplikasi ClickOnce berisi komponen COM yang ingin disebarkannya menggunakan COM bebas pendaftaran. Elemen ini memiliki atribut berikut.
Atribut | Deskripsi |
---|---|
clsid |
Harus diisi. ID kelas komponen COM yang dinyatakan sebagai GUID. |
description |
Opsional. Nama kelas. |
threadingModel |
Opsional. Model utas yang digunakan oleh kelas COM dalam proses. Jika properti ini null, tidak ada model utas yang digunakan. Komponen dibuat di utas utama klien dan panggilan dari utas lain dirangkai ke utas ini. Daftar berikut ini memperlihatkan nilai yang valid:Apartment , Free , Both , dan Neutral . |
tlbid |
Opsional. GUID pustaka jenis untuk komponen COM ini. |
progid |
Opsional. Pengidentifikasi terprogram yang bergantung versi yang terkait dengan komponen COM. Format ProgID adalah <vendor>.<component>.<version> . |
miscStatus |
Opsional. Duplikat dalam rakitan menunjukkan informasi yang disediakan oleh kunci registri MiscStatus . Jika nilai untuk atribut miscStatusIcon , miscStatusContent , miscStatusDocprint , atau miscStatusThumbnail tidak ditemukan, nilai default terkait yang tercantum di miscStatus digunakan untuk atribut yang tidak ada. Nilai dapat berupa daftar nilai atribut yang dipisahkan koma dari tabel berikut. Anda dapat menggunakan atribut ini jika kelas COM adalah kelas OCX yang memerlukan nilai kunci registri MiscStatus . |
miscStatusIcon |
Opsional. Duplikat dalam rakitan menunjukkan informasi yang disediakan oleh DVASPECT_ICON. Ini dapat memberikan ikon objek. Nilai dapat berupa daftar nilai atribut yang dipisahkan koma dari tabel berikut. Anda dapat menggunakan atribut ini jika kelas COM adalah kelas OCX yang memerlukan nilai kunci registri Miscstatus . |
miscStatusContent |
Opsional. Duplikat dalam rakitan menunjukkan informasi yang diberikan oleh DVASPECT_CONTENT. Ini dapat menyediakan dokumen campuran yang dapat ditampilkan untuk layar atau printer. Nilai dapat berupa daftar nilai atribut yang dipisahkan koma dari tabel berikut. Anda dapat menggunakan atribut ini jika kelas COM adalah kelas OCX yang memerlukan nilai kunci registri MiscStatus . |
miscStatusDocPrint |
Opsional. Duplikat dalam rakitan menunjukkan informasi yang diberikan oleh DVASPECT_DOCPRINT. Ini dapat menyediakan representasi objek yang dapat ditampilkan pada layar seolah-olah dicetak oleh printer. Nilai dapat berupa daftar nilai atribut yang dipisahkan koma dari tabel berikut. Anda dapat menggunakan atribut ini jika kelas COM adalah kelas OCX yang memerlukan nilai kunci registri MiscStatus . |
miscStatusThumbnail |
Opsional. Duplikat dalam rakitan menunjukkan informasi yang disediakan oleh DVASPECT_THUMBNAIL. Ini dapat memberikan gambar mini objek yang dapat ditampilkan di alat penelusuran. Nilai dapat berupa daftar nilai atribut yang dipisahkan koma dari tabel berikut. Anda dapat menggunakan atribut ini jika kelas COM adalah kelas OCX yang memerlukan nilai kunci registri MiscStatus . |
comInterfaceExternalProxyStub
Elemen comInterfaceExternalProxyStub
adalah turunan opsional dari elemen file
, tetapi mungkin diperlukan jika aplikasi ClickOnce berisi komponen COM yang ingin disebarkannya menggunakan COM bebas pendaftaran. Elemen tersebut berisi atribut berikut.
Atribut | Deskripsi |
---|---|
iid |
Harus diisi. ID antarmuka (IID) yang dilayani oleh proxy ini. IID harus memiliki kurung kurawal di sekitarnya. |
baseInterface |
Opsional. IID antarmuka tempat antarmuka yang dirujuk oleh iid berasal. |
numMethods |
Opsional. Jumlah metode yang diterapkan oleh antarmuka. |
name |
Opsional. Nama antarmuka seperti yang akan muncul dalam kode. |
tlbid |
Opsional. Pustaka jenis yang berisi deskripsi antarmuka yang ditentukan oleh atribut iid . |
proxyStubClass32 |
Opsional. Memetakan IID ke CLSID dalam DLL proxy 32-bit. |
comInterfaceProxyStub
Elemen comInterfaceProxyStub
adalah turunan opsional dari elemen file
, tetapi mungkin diperlukan jika aplikasi ClickOnce berisi komponen COM yang ingin disebarkannya menggunakan COM bebas pendaftaran. Elemen tersebut berisi atribut berikut.
Atribut | Deskripsi |
---|---|
iid |
Harus diisi. ID antarmuka (IID) yang dilayani oleh proxy ini. IID harus memiliki kurung kurawal di sekitarnya. |
baseInterface |
Opsional. IID antarmuka tempat antarmuka yang dirujuk oleh iid berasal. |
numMethods |
Opsional. Jumlah metode yang diterapkan oleh antarmuka. |
Name |
Opsional. Nama antarmuka seperti yang akan muncul dalam kode. |
Tlbid |
Opsional. Pustaka jenis yang berisi deskripsi antarmuka yang ditentukan oleh atribut iid . |
proxyStubClass32 |
Opsional. Memetakan IID ke CLSID dalam DLL proxy 32-bit. |
threadingModel |
Opsional. Opsional. Model utas yang digunakan oleh kelas COM dalam proses. Jika properti ini null, tidak ada model utas yang digunakan. Komponen dibuat di utas utama klien dan panggilan dari utas lain dirangkai ke utas ini. Daftar berikut ini memperlihatkan nilai yang valid:Apartment , Free , Both , dan Neutral . |
windowClass
Elemen windowClass
adalah turunan opsional dari elemen file
, tetapi mungkin diperlukan jika aplikasi ClickOnce berisi komponen COM yang ingin disebarkannya menggunakan COM bebas pendaftaran. Elemen tersebut mengacu pada kelas jendela yang ditentukan oleh komponen COM yang harus memiliki versi yang diterapkan padanya. Elemen tersebut berisi atribut berikut.
Atribut | Deskripsi |
---|---|
versioned |
Opsional. Mengontrol apakah nama kelas jendela internal yang digunakan dalam pendaftaran berisi versi rakitan yang berisi kelas jendela. Nilai atribut ini dapat berupa yes atau no . Default adalah yes . Nilai no hanya boleh digunakan jika kelas jendela yang sama ditentukan oleh komponen berdampingan dan komponen non-berdampingan yang setara, dan Anda ingin menggunakannya sebagai kelas jendela yang sama. Perhatikan bahwa aturan biasa tentang pendaftaran kelas jendela berlaku—hanya komponen pertama yang mendaftarkan kelas jendela yang dapat mendaftarkannya, karena tidak ada versi yang diterapkan padanya. |
Hash
Elemen hash
adalah turunan opsional elemen file
. Elemen hash
tidak memiliki atribut.
ClickOnce menggunakan algoritma hash untuk semua file di aplikasi sebagai pemeriksaan keamanan, untuk memastikan bahwa tidak ada file yang diubah setelah penyebaran. Jika elemen hash
tidak disertakan, pemeriksaan ini tidak akan dilakukan. Oleh karena itu, tidak disarankan untuk menghilangkan elemen hash
.
Jika manifes berisi file yang tidak di-hash, manifes tersebut tidak dapat ditandatangani secara digital, karena pengguna tidak dapat memverifikasi konten file yang tidak di-hash.
dsig:Transforms
Elemen dsig:Transforms
adalah turunan yang diperlukan elemen hash
. Elemen dsig:Transforms
tidak memiliki atribut.
dsig:Transform
Elemen dsig:Transform
adalah turunan yang diperlukan elemen dsig:Transforms
. Elemen dsig:Transform
memiliki atribut berikut.
Atribut | Deskripsi |
---|---|
Algorithm |
Algoritma digunakan untuk menghitung hash untuk file ini. Satu-satunya nilai saat ini yang digunakan oleh ClickOnce adalah urn:schemas-microsoft-com:HashTransforms.Identity . |
dsig:DigestMethod
Elemen dsig:DigestMethod
adalah turunan yang diperlukan elemen hash
. Elemen dsig:DigestMethod
memiliki atribut berikut.
Atribut | Deskripsi |
---|---|
Algorithm |
Algoritma digunakan untuk menghitung hash untuk file ini. Satu-satunya nilai saat ini yang digunakan oleh ClickOnce adalah http://www.w3.org/2000/09/xmldsig#sha1 . |
dsig:DigestValue
Elemen dsig:DigestValue
adalah turunan yang diperlukan elemen hash
. Elemen dsig:DigestValue
tidak memiliki atribut. Nilai teksnya adalah hash yang dihitung untuk file yang ditentukan.
Keterangan
Elemen ini mengidentifikasi semua file non-rakitan yang membentuk aplikasi dan, khususnya, nilai hash untuk verifikasi file. Elemen ini juga dapat menyertakan data isolasi Model Objek Komponen (COM) yang terkait dengan file. Jika file berubah, file manifes aplikasi juga harus diperbarui untuk mencerminkan perubahan.
Contoh
Contoh kode berikut mengilustrasikan elemen file
dalam manifes aplikasi untuk aplikasi yang disebarkan menggunakan ClickOnce.
<file name="Icon.ico" size="9216">
<hash>
<dsig:Transforms>
<dsig:Transform Algorithm="urn:schemas-microsoft-com:HashTransforms.Identity" />
</dsig:Transforms>
<dsig:DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1" />
<dsig:DigestValue>lVoj+Rh6RQ/HPNLOdayQah5McrI=</dsig:DigestValue>
</hash>
</file>