<file> elemen (aplikasi ClickOnce)

Artikel
10/10/2023

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.

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>

Bagikan melalui