<file> Öğesi (ClickOnce Uygulaması)

Makale
08/01/2011

Karşıdan yüklenen ve uygulama tarafından kullanılan tüm nonassembly dosyaları tanımlar.

<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. Öğenin öznitelikleri şunlardır:

Öznitelik	Açyklama
name	Gerekli. Uygulamanın adını tanımlar.
size	Gerekli. Arabelleğin bayt cinsinden boyutunu belirtir.
group	optional öğesi belirtilmemişse veya false olarak ayarlanmışsa isteğe bağlı; optional true ise gerekli. Dosyanın ait olduğu grubun adı. Ad geliştirici tarafından seçilen herhangi bir Unicode dize değeri olabilir ve ApplicationDeployment sınıfı ile isteğe bağlı olarak dosyaları karşıdan yükleme için kullanılır.
optional	İsteğe Bağlı. Uygulama ilk çalıştırıldığında bu dosyanın karşıdan yüklenmesinin gerekip gerekmediğini veya isteğe bağlı olarak uygulama talep edene kadar dosyanın sunucu tarafında bulunup bulunmaması gerektiğini belirtir. False ise veya tanımlanmamışsa, uygulama ilk çalıştırıldığında veya yüklendiğinde dosya karşıdan yüklenir. true ise, geçerli olması için group uygulama bildirimi için belirtilmelidir. writeableType, applicationData değeri ile belirtilirse, optional doğru (true) olamaz .
writeableType	İsteğe Bağlı. Dosyanın bir veri dosyası olduğunu belirtir. applicationData şu anda desteklenen tek değerdir.

typelib

typelib öğesi, dosya öğesinin isteğe bağlı bir alt nesnesidir. Bu öğe COM bileşenine ait tür kitaplığını açıklar. Öğenin öznitelikleri şunlardır:

Öznitelik	Açyklama
tlbid	Gerekli. GUID tür kitaplığına atanmıştır.
version	Gerekli. Tür kitaplığının sürüm numarası.
helpdir	Gerekli. Bileşen için Yardım dosyaları içeren dizin. Sıfır uzunluklu olabilir.
resourceid	İsteğe Bağlı. Yerel ayar tanıtıcısının (LCID) onaltılık dize gösterimi. 0x öneki olmayan ve önünde sıfır olmayan birden dörde onaltılık (hexadecimal) basamaklardır. LCID bağımısız bir alt dil tanımlayıcısına sahip olabilir.
flags	İsteğe Bağlı. Bu tür kitaplık için tür kitaplık bayrakları dize gösterimi. Tam olarak şunlardan birisi olmalıdır: "RESTRICTED", "CONTROL", "HIDDEN" ve "HASDISKIMAGE"

comClass

comClass öğesi file öğesinin isteğe bağlı bir alt öğesidir ama ClickOnce uygulaması kayıtsız COM kullanarak dağıtımı amaçlayan bir COM bileşeni içeriyorsa bu öğe gereklidir. Öğenin öznitelikleri şunlardır:

Öznitelik	Açıklama
clsid	Gerekli. COM bileşeninin sınıf kimliği GUID olarak ifade edilir.
description	İsteğe Bağlı. Sınıf (class) adı.
threadingModel	İsteğe Bağlı. İşlem üzerindeki COM sınıfları tarafından kullanılan iş parçacığı modeli Bu özellik boşsa (null), iş parçacığı modeli kullanılmaz. Bileşen sunucunun ana iş parçacığı (thread) üzerinde oluşturulur ve bu iş parçacığına sıralanmış diğer iş parçacıklarından çağırır. Aşağıdaki liste, geçerli değerleri gösterir: Apartment, Free, Both, ve Neutral.
tlbid	İsteğe Bağlı. Bu COM bileşenine ait tür kitaplığı için GUID.
progid	İsteğe Bağlı. COM bileşeni ile ilgili sürüme bağımlı program tanımlayıcısı ProgID'nin formatı <vendor>.<component>.<version> şeklindedir.
miscStatus	İsteğe Bağlı. Bütünleştirilmiş kod bildiriminde, MiscStatus kayıt anahtarı tarafından sağlanan bilgiyi çoğaltır. miscStatusIcon, miscStatusContent, miscStatusDocprint veya miscStatusThumbnail öznitelikleri için değerler bulunamazsa, miscStatus içinde karşılık gelen varsayılan değer eksik önitelikler için kullanılır. Değer aşağıdaki tablodan öznitelik değerlerinin virgülle ayrılmış bir listesi olabilir. COM sınıfı MiscStatus kayıt defteri anahtarı değerleri gerektiren bir OCX sınıfı olursa, bu özniteliği kullanabilirsiniz.
miscStatusIcon	İsteğe Bağlı. Bütünleştirilmiş kod bildirimi içinde DVASPECT_ICON tarafından sağlanan bilgileri çoğaltır. Bir nesnenin simgesini sağlayabilir. Değer aşağıdaki tablodan öznitelik değerlerinin virgülle ayrılmış bir listesi olabilir. COM sınıfı Miscstatus kayıt defteri anahtarı değerleri gerektiren bir OCX sınıfı olursa, bu özniteliği kullanabilirsiniz.
miscStatusContent	İsteğe Bağlı. Bütünleştirilmiş kod bildirimi içinde DVASPECT_ICON tarafından sağlanan bilgileri çoğaltır. Bir ekran veya yazıcı için görüntülenebilir bir bileşik belge sağlar. Değer aşağıdaki tablodan öznitelik değerlerinin virgülle ayrılmış bir listesi olabilir. COM sınıfı MiscStatus kayıt defteri anahtarı değerleri gerektiren bir OCX sınıfı olursa, bu özniteliği kullanabilirsiniz.
miscStatusDocPrint	İsteğe Bağlı. Bütünleştirilmiş kod bildirimi içinde DVASPECT_ICON tarafından sağlanan bilgileri çoğaltır. Bir yazıcıya yazdırılmış gibi ekran üzerinde görüntülenebilir bir nesne gösterimi sağlar. Değer aşağıdaki tablodan öznitelik değerlerinin virgülle ayrılmış bir listesi olabilir. COM sınıfı MiscStatus kayıt defteri anahtarı değerleri gerektiren bir OCX sınıfı olursa, bu özniteliği kullanabilirsiniz.
miscStatusThumbnail	İsteğe Bağlı. Bütünleştirilmiş kod bildirimi içinde DVASPECT_ICON tarafından sağlanan bilgileri çoğaltır. Tarama aracı içinde görüntülenebilir nesnenin küçük resmini sağlar. Değer aşağıdaki tablodan öznitelik değerlerinin virgülle ayrılmış bir listesi olabilir. COM sınıfı MiscStatus kayıt defteri anahtarı değerleri gerektiren bir OCX sınıfı olursa, bu özniteliği kullanabilirsiniz.

comInterfaceExternalProxyStub

comInterfaceExternalProxyStub öğesi file öğesinin isteğe bağlı bir alt öğesidir ama ClickOnce uygulaması kayıtsız COM kullanarak dağıtımı amaçlayan bir COM bileşeni içeriyorsa bu öğe gereklidir. Bu öğenin öznitelikleri şunlardır:

Öznitelik	Açıklama
iid	Gerekli. Bu proxy tarafından hizmet verilen arabirim kimliği (IID). IID, parantezler ({}) arasında olmalıdır.
baseInterface	İsteğe Bağlı. iid tarafından referans edilen arabirimin IID'si.
numMethods	İsteğe Bağlı. Arabirimi tarafından uygulanan yöntemlerin sayısı.
name	İsteğe Bağlı. Kod içinde görüntülenecek arabirimin adı.
tlbid	İsteğe Bağlı. iid özniteliği tarafından belirtilen arabirimin açıklamasını içeren tür kitaplığı.
proxyStubClass32	İsteğe Bağlı. 32-Bit proxy DLL'ler içinde IID'yi bir CLSID'e eşleştirir.

comInterfaceProxyStub

comInterfaceProxyStub öğesi file öğesinin isteğe bağlı bir alt öğesidir ama ClickOnce uygulaması kayıtsız COM kullanarak dağıtımı amaçlayan bir COM bileşeni içeriyorsa bu öğe gereklidir. Bu öğenin öznitelikleri şunlardır:

Öznitelik	Açıklama
iid	Gerekli. Bu proxy tarafından hizmet verilen arabirim kimliği (IID). IID, parantezler ({}) arasında olmalıdır.
baseInterface	İsteğe Bağlı. iid tarafından referans edilen arabirimin IID'si.
numMethods	İsteğe Bağlı. Arabirimi tarafından uygulanan yöntemlerin sayısı.
Name	İsteğe Bağlı. Kod içinde görüntülenecek arabirimin adı.
Tlbid	İsteğe Bağlı. iid özniteliği tarafından belirtilen arabirimin açıklamasını içeren tür kitaplığı.
proxyStubClass32	İsteğe Bağlı. 32-Bit proxy DLL'ler içinde IID'yi bir CLSID'e eşleştirir.
threadingModel	İsteğe Bağlı. İsteğe Bağlı. İşlem üzerindeki COM sınıfları tarafından kullanılan iş parçacığı modeli Bu özellik boşsa (null), iş parçacığı modeli kullanılmaz. Bileşen sunucunun ana iş parçacığı (thread) üzerinde oluşturulur ve bu iş parçacığına sıralanmış diğer iş parçacıklarından çağırır. Aşağıdaki liste, geçerli değerleri gösterir: Apartment, Free, Both, ve Neutral.

windowClass

windowClass öğesi file öğesinin isteğe bağlı bir alt öğesidir ama ClickOnce uygulaması kayıtsız COM kullanarak dağıtımı amaçlayan bir COM bileşeni içeriyorsa bu öğe gereklidir. Öğe, kendisine uygulanabilen bir sürüme sahip COM bileşeni tarafından tanımlanan bir pencere sınıfın gösterir. Bu öğenin öznitelikleri şunlardır:

Öznitelik	Açıklama
versioned	İsteğe Bağlı. Kayıt için kullanılan iç pencere sınıf adının pencere sınıfı içeren bütünleştirilmiş kod sürümünü içerip içermediğini kontrol eder. Bu özniteliğin değeri Evet veya Hayır olabilir. Varsayılan değer evet'tir. Hayır değeri yalnızca aynı pencere sınıfı yan yana bileşen ile yan yana olmayan eşdeğer bileşen tarafından tanımlanmış ve bunlara aynı pencere sınıfı olarak davranmak istiyorsanız kullanılmalıdır. Pencere sınıfı kaydı hakkında genel kurallar sadece kendisini kaydedebilecek bir pencere sınıfını kaydeden birinci bileşene uygulanabildiğine dikkat edin. Çünkü kendisine uygulanabilen bir sürüme sahip değildir.

versioned

İsteğe Bağlı. Kayıt için kullanılan iç pencere sınıf adının pencere sınıfı içeren bütünleştirilmiş kod sürümünü içerip içermediğini kontrol eder. Bu özniteliğin değeri Evet veya Hayır olabilir. Varsayılan değer evet'tir. Hayır değeri yalnızca aynı pencere sınıfı yan yana bileşen ile yan yana olmayan eşdeğer bileşen tarafından tanımlanmış ve bunlara aynı pencere sınıfı olarak davranmak istiyorsanız kullanılmalıdır. Pencere sınıfı kaydı hakkında genel kurallar sadece kendisini kaydedebilecek bir pencere sınıfını kaydeden birinci bileşene uygulanabildiğine dikkat edin. Çünkü kendisine uygulanabilen bir sürüme sahip değildir.

karma

hash öğesi, file öğesinin isteğe bağlı bir alt nesnesidir. hash öğesi özniteliklere sahip değildir.

Dağıtım sonrası hiçbir dosyanın değişmediğinden emin olmak için, ClickOnce uygulamasında yer alan tüm dosyaların algoritmik bir karmasını güvenlik denetimi olarak kullanır. hash öğesi dahil değilse, bu denetim gerçekleştirilmez. Bu nedenle, hash öğesini atlama önerilmez.

Bildirim karma (hashed) olmayan bir dosya içeriyorsa, bu bildirim dijital imzalı olamaz, çünkü kullanıcılar karma olmayan (unhashed) bir dosyanın içeriğini doğrulayamaz.

dsig:Transforms

dsig:Transforms öğesi, hash öğesinin isteğe bağlı bir alt nesnesidir. dsig:Transforms öğesi özniteliklere sahip değildir.

dsig:Transform

dsig:Transform öğesi, dsig:Transforms öğesinin isteğe bağlı bir alt nesnesidir. dsig:Transform öğesinin öznitelikleri şunlardır:

Öznitelik	Açıklama
Algorithm	Bu dosyaya ait özeti hesaplamak için kullanılan algoritma. Şu anda ClickOnce tarafından kullanılan tek değer, urn:schemas-microsoft-com:HashTransforms.Identity değeridir.

dsig:DigestMethod

dsig:DigestMethod öğesi, hash öğesinin isteğe bağlı bir alt nesnesidir. dsig:DigestMethod öğesinin öznitelikleri şunlardır:

Öznitelik	Açıklama
Algorithm	Bu dosyaya ait özeti hesaplamak için kullanılan algoritma. Şu anda ClickOnce tarafından kullanılan tek değer http://www.w3.org/2000/09/xmldsig#sha1 değeridir.

dsig:DigestValue

dsig:DigestValue öğesi, hash öğesinin isteğe bağlı bir alt nesnesidir. dsig:DigestValue öğesi özniteliklere sahip değildir. Belirtilen dosya için hesaplanan karma kendi metin değeridir.

Açıklamalar

Bu öğe uygulamayı oluşturan tüm derleme olmayan dosyaları, özellikle dosya doğrulama için karma değerleri, tanımlar. Bu öğe dosya ile ilişkili Nesne Modeli (COM) yalıtım verisini de içerebilir. Bir dosya değiştiğinde uygulama bildirim dosyası da değişikliği yansıtmak için güncelleştirilmelidir.

Örnek

Aşağıdaki kod örneği bir ClickOnce uygulaması için uygulama bildiriminde yer alan file öğesini gösterir.

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

Başvuru

ClickOnce Uygulama Bildirimi

Aracılığıyla paylaş