<file> öğesi (ClickOnce uygulaması)

Makale
08/25/2023

Uygulama tarafından indirilen ve kullanılan tüm ayrıştırılmayan dosyaları tanımlar.

Sözdizimi

<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>

Öğeler ve öznitelikler

file öğesi isteğe bağlıdır. öğesi aşağıdaki özniteliklere sahiptir.

Öznitelik	Açıklama
`name`	Gerekli. Dosyanın adını tanımlar.
`size`	Gerekli. Dosyanın boyutunu bayt cinsinden belirtir.
`group`	İsteğe bağlı olarak, özniteliği belirtilmemişse veya olarak ayarlanmadıysa `optional` `false`; ise `optional` `true`gereklidir. Bu dosyanın ait olduğu grubun adı. Ad, geliştirici tarafından seçilen herhangi bir Unicode dize değeri olabilir ve sınıfıyla ApplicationDeployment isteğe bağlı dosyaları indirmek için kullanılır.
`optional`	isteğe bağlı. Uygulama ilk kez çalıştırıldığında bu dosyanın indirilip indirilmeyeceğini veya uygulama isteğe bağlı olarak isteyene kadar dosyanın yalnızca sunucuda bulunup bulunmayacağını belirtir. Tanımlanmamışsa veya tanımlanmamışsa `false` , uygulama ilk kez çalıştırıldığında veya yüklendiğinde dosya indirilir. ise `true`, uygulama bildiriminin geçerli olması için bir `group` belirtilmelidir. `optional`değeriyle `applicationData`belirtilirse `writeableType` true olamaz.
`writeableType`	isteğe bağlı. Bu dosyanın bir veri dosyası olduğunu belirtir. Şu anda tek geçerli değer şeklindedir `applicationData`.

Typelib

typelib öğesi, dosya öğesinin isteğe bağlı bir alt öğesidir. öğesi, COM bileşenine ait tür kitaplığını açıklar. öğesi aşağıdaki özniteliklere sahiptir.

Öznitelik	Açıklama
`tlbid`	Gerekli. Tür kitaplığına atanan GUID.
`version`	Gerekli. Tür kitaplığının sürüm numarası.
`helpdir`	Gerekli. Bileşenin Yardım dosyalarını içeren dizin. Sıfır uzunluklu olabilir.
`resourceid`	isteğe bağlı. Yerel ayar tanımlayıcısının (LCID) onaltılık dize gösterimi. 0x ön eki olmayan ve önünde sıfır olmayan bir ila dört onaltılık basamaktır. LCID'nin nötr bir alt dil tanımlayıcısı olabilir.
`flags`	isteğe bağlı. Bu tür kitaplığı için tür kitaplığı bayraklarının dize gösterimi. Özellikle, "RESTRICTED", "CONTROL", "HIDDEN" ve "HASDISKIMAGE" öğelerinden biri olmalıdır.

comClass

comClass öğesi, öğesinin file isteğe bağlı bir alt öğesidir, ancak ClickOnce uygulaması kayıtsız COM kullanarak dağıtmayı planladığı bir COM bileşeni içeriyorsa gereklidir. öğesi aşağıdaki özniteliklere sahiptir.

Öznitelik	Açıklama
`clsid`	Gerekli. GUID olarak ifade edilen COM bileşeninin sınıf kimliği.
`description`	isteğe bağlı. Sınıf adı.
`threadingModel`	isteğe bağlı. İşlem içi COM sınıfları tarafından kullanılan iş parçacığı oluşturma modeli. Bu özellik null ise, iş parçacığı modeli kullanılmaz. Bileşen istemcinin ana iş parçacığında oluşturulur ve diğer iş parçacıklarından gelen çağrılar bu iş parçacığına sıralanır. Aşağıdaki listede geçerli değerler gösterilmektedir: `Apartment`, , `Free`, `Both` ve `Neutral`.
`tlbid`	isteğe bağlı. Bu COM bileşeni için tür kitaplığı guid'i.
`progid`	isteğe bağlı. COM bileşeniyle ilişkili sürüme bağımlı programlı tanımlayıcı. `ProgID` biçimi şeklindedir`<vendor>.<component>.<version>`.
`miscStatus`	isteğe bağlı. Derlemedeki yinelenenler, kayıt defteri anahtarı tarafından `MiscStatus` sağlanan bilgileri bildirir. , , `miscStatusContentmiscStatusDocprint`veya `miscStatusThumbnail` özniteliklerinin `miscStatusIcon`değerleri bulunamazsa, içinde listelenen `miscStatus` karşılık gelen varsayılan değer eksik öznitelikler için kullanılır. Değer, aşağıdaki tabloda yer alan öznitelik değerlerinin virgülle ayrılmış bir listesi olabilir. COM sınıfı kayıt defteri anahtarı değerleri gerektiren `MiscStatus` bir OCX sınıfıysa bu özniteliği kullanabilirsiniz.
`miscStatusIcon`	isteğe bağlı. Derlemede yinelenenler, DVASPECT_ICON tarafından sağlanan bilgileri bildirir. Bir nesnenin simgesini sağlayabilir. Değer, aşağıdaki tabloda yer alan öznitelik değerlerinin virgülle ayrılmış bir listesi olabilir. COM sınıfı kayıt defteri anahtarı değerleri gerektiren `Miscstatus` bir OCX sınıfıysa bu özniteliği kullanabilirsiniz.
`miscStatusContent`	isteğe bağlı. Derlemede yinelenenler, DVASPECT_CONTENT tarafından sağlanan bilgileri bildirir. Ekran veya yazıcı için görüntülenebilir bileşik bir belge sağlayabilir. Değer, aşağıdaki tabloda yer alan öznitelik değerlerinin virgülle ayrılmış bir listesi olabilir. COM sınıfı kayıt defteri anahtarı değerleri gerektiren `MiscStatus` bir OCX sınıfıysa bu özniteliği kullanabilirsiniz.
`miscStatusDocPrint`	isteğe bağlı. Derlemede yinelenenler, DVASPECT_DOCPRINT tarafından sağlanan bilgileri bildirir. Ekranda yazıcıya yazdırılmış gibi görüntülenebilir bir nesne gösterimi sağlayabilir. Değer, aşağıdaki tabloda yer alan öznitelik değerlerinin virgülle ayrılmış bir listesi olabilir. COM sınıfı kayıt defteri anahtarı değerleri gerektiren `MiscStatus` bir OCX sınıfıysa bu özniteliği kullanabilirsiniz.
`miscStatusThumbnail`	isteğe bağlı. Derlemede yinelenenler, DVASPECT_THUMBNAIL tarafından sağlanan bilgileri bildirir. Gözatma aracında görüntülenebilir bir nesnenin küçük resmini sağlayabilir. Değer, aşağıdaki tabloda yer alan öznitelik değerlerinin virgülle ayrılmış bir listesi olabilir. COM sınıfı kayıt defteri anahtarı değerleri gerektiren `MiscStatus` bir OCX sınıfıysa bu özniteliği kullanabilirsiniz.

comInterfaceExternalProxyStub

comInterfaceExternalProxyStub öğesi, öğesinin file isteğe bağlı bir alt öğesidir, ancak ClickOnce uygulaması kayıtsız COM kullanarak dağıtmayı planladığı bir COM bileşeni içeriyorsa gerekli olabilir. öğesi aşağıdaki öznitelikleri içerir.

Öznitelik	Açıklama
`iid`	Gerekli. Bu ara sunucu tarafından sunulan arabirim kimliği (IID). IID'nin çevresinde küme ayraçları olmalıdır.
`baseInterface`	isteğe bağlı. tarafından başvurulan `iid` arabirimin türetildiği arabirimin IID değeri.
`numMethods`	isteğe bağlı. Arabirimi tarafından uygulanan yöntemlerin sayısı.
`name`	isteğe bağlı. Kodda görüneceği şekilde arabirimin adı.
`tlbid`	isteğe bağlı. özniteliği tarafından `iid` belirtilen arabirimin açıklamasını içeren tür kitaplığı.
`proxyStubClass32`	isteğe bağlı. 32 bit proxy DLL'lerinde CLSID'ye IID Haritalar.

comInterfaceProxyStub

comInterfaceProxyStub öğesi, öğesinin file isteğe bağlı bir alt öğesidir, ancak ClickOnce uygulaması kayıtsız COM kullanarak dağıtmayı planladığı bir COM bileşeni içeriyorsa gerekli olabilir. öğesi aşağıdaki öznitelikleri içerir.

Öznitelik	Açıklama
`iid`	Gerekli. Bu ara sunucu tarafından sunulan arabirim kimliği (IID). IID'nin çevresinde küme ayraçları olmalıdır.
`baseInterface`	isteğe bağlı. tarafından başvurulan `iid` arabirimin türetildiği arabirimin IID değeri.
`numMethods`	isteğe bağlı. Arabirimi tarafından uygulanan yöntemlerin sayısı.
`Name`	isteğe bağlı. Kodda görüneceği şekilde arabirimin adı.
`Tlbid`	isteğe bağlı. özniteliği tarafından `iid` belirtilen arabirimin açıklamasını içeren tür kitaplığı.
`proxyStubClass32`	isteğe bağlı. 32 bit proxy DLL'lerinde CLSID'ye IID Haritalar.
`threadingModel`	isteğe bağlı. isteğe bağlı. İşlem içi COM sınıfları tarafından kullanılan iş parçacığı oluşturma modeli. Bu özellik null ise, iş parçacığı modeli kullanılmaz. Bileşen istemcinin ana iş parçacığında oluşturulur ve diğer iş parçacıklarından gelen çağrılar bu iş parçacığına sıralanır. Aşağıdaki listede geçerli değerler gösterilmektedir: `Apartment`, , `Free`, `Both` ve `Neutral`.

Windowclass

windowClass öğesi, öğesinin file isteğe bağlı bir alt öğesidir, ancak ClickOnce uygulaması kayıtsız COM kullanarak dağıtmayı planladığı bir COM bileşeni içeriyorsa gerekli olabilir. öğesi, COM bileşeni tarafından tanımlanan ve bu bileşene bir sürüm uygulanması gereken bir pencere sınıfına başvurur. öğesi aşağıdaki öznitelikleri içerir.

Öznitelik Açıklama

versioned isteğe bağlı. Kayıtta kullanılan iç pencere sınıfı adının pencere sınıfını içeren derleme sürümünü içerip içermediğini denetler. Bu özniteliğin değeri veya noolabiliryes. Varsayılan değer: yes. Değer no yalnızca aynı pencere sınıfı yan yana bir bileşen ve eşdeğer yan yana olmayan bir bileşen tarafından tanımlanıyorsa ve bunları aynı pencere sınıfı olarak işlemek istiyorsanız kullanılmalıdır. Pencere sınıfı kaydıyla ilgili her zamanki kuralların geçerli olduğunu unutmayın; yalnızca pencere sınıfını kaydeden ilk bileşen bunu kaydedebilir, çünkü bu bileşene uygulanmış bir sürümü yoktur.

Öznitelik	Açıklama
`versioned`	isteğe bağlı. Kayıtta kullanılan iç pencere sınıfı adının pencere sınıfını içeren derleme sürümünü içerip içermediğini denetler. Bu özniteliğin değeri veya `no`olabilir`yes`. Varsayılan değer: `yes`. Değer `no` yalnızca aynı pencere sınıfı yan yana bir bileşen ve eşdeğer yan yana olmayan bir bileşen tarafından tanımlanıyorsa ve bunları aynı pencere sınıfı olarak işlemek istiyorsanız kullanılmalıdır. Pencere sınıfı kaydıyla ilgili her zamanki kuralların geçerli olduğunu unutmayın; yalnızca pencere sınıfını kaydeden ilk bileşen bunu kaydedebilir, çünkü bu bileşene uygulanmış bir sürümü yoktur.

hash

hash öğesi, öğesinin file isteğe bağlı bir alt öğesidir. öğesinin hash özniteliği yok.

ClickOnce, dağıtımdan sonra dosyaların hiçbirinin değiştirilmediğinden emin olmak için bir uygulamadaki tüm dosyaların algoritmik karmasını güvenlik denetimi olarak kullanır. hash Öğesi dahil değilse, bu denetim gerçekleştirilmeyecektir. Bu nedenle, öğesinin atlanması hash önerilmez.

Bir bildirim karma olmayan bir dosya içeriyorsa, kullanıcılar unhashed dosyasının içeriğini doğrulayamadığından bu bildirim dijital olarak imzalanamaz.

dsig:Dönüşümler

dsig:Transforms öğesi, öğesinin hash gerekli bir alt öğesidir. öğesinin dsig:Transforms özniteliği yok.

dsig:Transform

dsig:Transform öğesi, öğesinin dsig:Transforms gerekli bir alt öğesidir. dsig:Transform öğesi aşağıdaki özniteliklere sahiptir.

Öznitelik	Açıklama
`Algorithm`	Bu dosyanın özetini hesaplamak için kullanılan algoritma. Şu anda ClickOnce tarafından kullanılan tek değerdir `urn:schemas-microsoft-com:HashTransforms.Identity`.

dsig:DigestMethod

dsig:DigestMethod öğesi, öğesinin hash gerekli bir alt öğesidir. dsig:DigestMethod öğesi aşağıdaki özniteliklere sahiptir.

Öznitelik	Açıklama
`Algorithm`	Bu dosyanın özetini hesaplamak için kullanılan algoritma. Şu anda ClickOnce tarafından kullanılan tek değerdir `http://www.w3.org/2000/09/xmldsig#sha1`.

dsig:DigestValue

dsig:DigestValue öğesi, öğesinin hash gerekli bir alt öğesidir. öğesinin dsig:DigestValue özniteliği yok. Metin değeri, belirtilen dosyanın hesaplanan karmasıdır.

Açıklamalar

Bu öğe, uygulamayı oluşturan tüm ayrıştırılmayan dosyaları ve özellikle de dosya doğrulaması için karma değerleri tanımlar. Bu öğe, dosyayla ilişkilendirilmiş Bileşen Nesne Modeli (COM) yalıtım verilerini de içerebilir. Bir dosya değişirse, uygulama bildirim dosyasının da değişikliği yansıtacak şekilde güncelleştirilmiş olması gerekir.

Örnek

Aşağıdaki kod örneği, ClickOnce kullanılarak dağıtılan bir uygulamanın uygulama bildirimindeki öğeleri gösterir file .

<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>

Ayrıca bkz.

ClickOnce uygulama bildirimi

Aracılığıyla paylaş