<elemen file> (aplikasi ClickOnce)

Mengidentifikasi semua file non-rakitan yang diunduh dan digunakan oleh aplikasi.

Sintaksis

<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 bersifat opsional. Elemen ini memiliki atribut berikut.

Attribute	Deskripsi
`name`	Required. Mengidentifikasi nama file.
`size`	Required. Menentukan ukuran, dalam byte, file.
`group`	Opsional, jika `optional` atribut 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 <xref:System.Deployment.Application.ApplicationDeployment> kelas .
`optional`	Optional. Menentukan apakah file ini harus diunduh ketika aplikasi pertama kali dijalankan, atau apakah file harus berada hanya di server sampai aplikasi memintanya sesuai permintaan. Jika `false` atau tidak ditentukan, file diunduh saat aplikasi pertama kali dijalankan atau diinstal. Jika `true`, harus `group` ditentukan agar manifes aplikasi valid. `optional` tidak boleh benar jika `writeableType` ditentukan dengan nilai `applicationData`.
`writeableType`	Optional. Menentukan bahwa file ini adalah file data. Saat ini satu-satunya nilai yang valid adalah `applicationData`.

typelib

Elemen typelib ini adalah turunan opsional dari elemen file. Elemen menjelaskan jenis pustaka yang termasuk dalam komponen COM. Elemen ini memiliki atribut berikut.

Attribute	Deskripsi
`tlbid`	Required. GUID yang ditetapkan ke pustaka jenis.
`version`	Required. Nomor versi pustaka jenis.
`helpdir`	Required. Direktori yang berisi file Bantuan untuk komponen. Mungkin panjang nol.
`resourceid`	Optional. Representasi string heksadesimal dari pengidentifikasi lokal (LCID). Ini adalah satu hingga empat digit heksadesimal tanpa awalan 0x dan tanpa nol di depannya. LCID mungkin memiliki pengidentifikasi sublanguage netral.
`flags`	Optional. Representasi string dari jenis bendera pustaka untuk pustaka jenis ini. Secara khusus, itu harus menjadi salah satu dari "RESTRICTED", "CONTROL", "HIDDEN" dan "HASDISKIMAGE".

comClass

Elemen comClass ini adalah turunan opsional dari file elemen, tetapi diperlukan jika aplikasi ClickOnce berisi komponen COM yang ingin disebarkan menggunakan COM bebas pendaftaran. Elemen ini memiliki atribut berikut.

Attribute	Deskripsi
`clsid`	Required. ID kelas komponen COM yang dinyatakan sebagai GUID.
`description`	Optional. Nama kelas.
`threadingModel`	Optional. Model utas yang digunakan oleh kelas COM dalam proses. Jika properti ini null, tidak ada model utas yang digunakan. Komponen dibuat pada utas utama klien dan panggilan dari utas lain dinaungi ke utas ini. Daftar berikut ini memperlihatkan nilai yang valid: `Apartment`, `Free`, `Both`, dan `Neutral`.
`tlbid`	Optional. GUID untuk pustaka jenis untuk komponen COM ini.
`progid`	Optional. Pengidentifikasi terprogram yang bergantung pada versi yang terkait dengan komponen COM. Format adalah `ProgID<vendor>.<component>.<version>`.
`miscStatus`	Optional. Duplikat dalam rakitan memanifestasikan informasi yang disediakan oleh `MiscStatus` kunci registri. Jika nilai untuk `miscStatusIcon`atribut , `miscStatusContent`, `miscStatusDocprint`, atau `miscStatusThumbnail` tidak ditemukan, nilai default terkait yang tercantum digunakan `miscStatus` untuk atribut yang hilang. Nilai dapat menjadi daftar nilai atribut yang dibatasi koma dari tabel berikut. Anda dapat menggunakan atribut ini jika kelas COM adalah kelas OCX yang memerlukan nilai kunci registri `MiscStatus` .
`miscStatusIcon`	Optional. Duplikat dalam rakitan memanifestasikan informasi yang disediakan oleh DVASPECT_ICON. Ini dapat menyediakan ikon objek. Nilai dapat menjadi daftar nilai atribut yang dibatasi koma dari tabel berikut. Anda dapat menggunakan atribut ini jika kelas COM adalah kelas OCX yang memerlukan nilai kunci registri `Miscstatus` .
`miscStatusContent`	Optional. Duplikat dalam rakitan memanifestasikan informasi yang disediakan oleh DVASPECT_CONTENT. Ini dapat menyediakan dokumen gabungan yang dapat ditampilkan untuk layar atau printer. Nilai dapat menjadi daftar nilai atribut yang dibatasi koma dari tabel berikut. Anda dapat menggunakan atribut ini jika kelas COM adalah kelas OCX yang memerlukan nilai kunci registri `MiscStatus` .
`miscStatusDocPrint`	Optional. Duplikat dalam rakitan memanifestasikan informasi yang disediakan oleh DVASPECT_DOCPRINT. Ini dapat menyediakan representasi objek yang dapat ditampilkan pada layar seolah-olah dicetak ke printer. Nilai dapat menjadi daftar nilai atribut yang dibatasi koma dari tabel berikut. Anda dapat menggunakan atribut ini jika kelas COM adalah kelas OCX yang memerlukan nilai kunci registri `MiscStatus` .
`miscStatusThumbnail`	Optional. Duplikat dalam rakitan memanifestasikan informasi yang disediakan oleh DVASPECT_THUMBNAIL. Ini dapat memberikan gambar mini objek yang dapat ditampilkan dalam alat penjelajahan. Nilai dapat menjadi daftar nilai atribut yang dibatasi koma dari tabel berikut. Anda dapat menggunakan atribut ini jika kelas COM adalah kelas OCX yang memerlukan nilai kunci registri `MiscStatus` .

comInterfaceExternalProxyStub

Elemen comInterfaceExternalProxyStub ini adalah turunan opsional dari file elemen, tetapi mungkin diperlukan jika aplikasi ClickOnce berisi komponen COM yang ingin disebarkan menggunakan COM bebas pendaftaran. Elemen berisi atribut berikut.

Attribute	Deskripsi
`iid`	Required. ID antarmuka (IID) yang dilayani oleh proksi ini. IID harus memiliki kurung kurawal di sekitarnya.
`baseInterface`	Optional. IID antarmuka tempat antarmuka yang dirujuk oleh `iid` diturunkan.
`numMethods`	Optional. Jumlah metode yang diterapkan oleh antarmuka.
`name`	Optional. Nama antarmuka seperti yang akan muncul dalam kode.
`tlbid`	Optional. Pustaka jenis yang berisi deskripsi antarmuka yang ditentukan oleh `iid` atribut .
`proxyStubClass32`	Optional. Memetakan IID ke CLSID di DLL proksi 32-bit.

comInterfaceProxyStub

Elemen comInterfaceProxyStub ini adalah turunan opsional dari file elemen, tetapi mungkin diperlukan jika aplikasi ClickOnce berisi komponen COM yang ingin disebarkan menggunakan COM bebas pendaftaran. Elemen berisi atribut berikut.

Attribute	Deskripsi
`iid`	Required. ID antarmuka (IID) yang dilayani oleh proksi ini. IID harus memiliki kurung kurawal di sekitarnya.
`baseInterface`	Optional. IID antarmuka tempat antarmuka yang dirujuk oleh `iid` diturunkan.
`numMethods`	Optional. Jumlah metode yang diterapkan oleh antarmuka.
`Name`	Optional. Nama antarmuka seperti yang akan muncul dalam kode.
`Tlbid`	Optional. Pustaka jenis yang berisi deskripsi antarmuka yang ditentukan oleh `iid` atribut .
`proxyStubClass32`	Optional. Memetakan IID ke CLSID di DLL proksi 32-bit.
`threadingModel`	Optional. Optional. Model utas yang digunakan oleh kelas COM dalam proses. Jika properti ini null, tidak ada model utas yang digunakan. Komponen dibuat pada utas utama klien dan panggilan dari utas lain dinaungi ke utas ini. Daftar berikut ini memperlihatkan nilai yang valid: `Apartment`, `Free`, `Both`, dan `Neutral`.

windowClass

Elemen windowClass ini adalah turunan opsional dari file elemen, tetapi mungkin diperlukan jika aplikasi ClickOnce berisi komponen COM yang ingin disebarkan menggunakan COM bebas pendaftaran. Elemen mengacu pada kelas jendela yang ditentukan oleh komponen COM yang harus memiliki versi yang diterapkan padanya. Elemen berisi atribut berikut.

Attribute Deskripsi

versioned Optional. Mengontrol apakah nama kelas jendela internal yang digunakan dalam pendaftaran berisi versi rakitan yang berisi kelas jendela. Nilai atribut ini bisa atau yesno. Defaultnya adalah yes. Nilai no hanya boleh digunakan jika kelas jendela yang sama didefinisikan oleh komponen berdampingan dan komponen non-berdampingan yang setara dan Anda ingin memperlakukannya sebagai kelas jendela yang sama. Perhatikan bahwa aturan biasa tentang pendaftaran kelas jendela berlaku—hanya komponen pertama yang mendaftarkan kelas jendela yang akan dapat mendaftarkannya, karena tidak memiliki versi yang diterapkan padanya.

Attribute	Deskripsi
`versioned`	Optional. Mengontrol apakah nama kelas jendela internal yang digunakan dalam pendaftaran berisi versi rakitan yang berisi kelas jendela. Nilai atribut ini bisa atau `yesno`. Defaultnya adalah `yes`. Nilai `no` hanya boleh digunakan jika kelas jendela yang sama didefinisikan oleh komponen berdampingan dan komponen non-berdampingan yang setara dan Anda ingin memperlakukannya sebagai kelas jendela yang sama. Perhatikan bahwa aturan biasa tentang pendaftaran kelas jendela berlaku—hanya komponen pertama yang mendaftarkan kelas jendela yang akan dapat mendaftarkannya, karena tidak memiliki versi yang diterapkan padanya.

hash

Elemen hash ini adalah turunan opsional dari file elemen . Elemen hash tidak memiliki atribut.

ClickOnce menggunakan hash algoritma dari semua file dalam aplikasi sebagai pemeriksaan keamanan, untuk memastikan bahwa tidak ada file yang diubah setelah penyebaran. hash Jika elemen tidak disertakan, pemeriksaan ini tidak akan dilakukan. Oleh karena itu, menghilangkan hash elemen tidak disarankan.

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 ini adalah turunan elemen yang hash diperlukan. Elemen dsig:Transforms tidak memiliki atribut.

dsig:Transform

Elemen dsig:Transform ini adalah turunan elemen yang dsig:Transforms diperlukan. Elemen dsig:Transform ini memiliki atribut berikut.

Attribute	Deskripsi
`Algorithm`	Algoritma yang digunakan untuk menghitung hash untuk file ini. Saat ini satu-satunya nilai yang digunakan oleh ClickOnce adalah `urn:schemas-microsoft-com:HashTransforms.Identity`.

dsig:DigestMethod

Elemen dsig:DigestMethod ini adalah turunan elemen yang hash diperlukan. Elemen dsig:DigestMethod ini memiliki atribut berikut.

Attribute	Deskripsi
`Algorithm`	Algoritma yang digunakan untuk menghitung hash untuk file ini. Saat ini satu-satunya nilai yang digunakan oleh ClickOnce adalah `http://www.w3.org/2000/09/xmldsig#sha1`.

dsig:DigestValue

Elemen dsig:DigestValue ini adalah turunan elemen yang hash diperlukan. Elemen dsig:DigestValue tidak memiliki atribut. Nilai teksnya adalah hash komputasi untuk file yang ditentukan.

Komentar

Elemen ini mengidentifikasi semua file nonassembly 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.

Example

Contoh kode berikut mengilustrasikan file elemen 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>

Saran dan Komentar

Apakah halaman ini membantu?

Last updated on 2026-08-28