< dependency> Öğesi (ClickOnce Uygulaması)
Uygulama için gerekli olan bir platform veya derleme bağımlılığı tanımlar.
<dependency>
<dependentOS
supportURL
description
>
<osVersionInfo>
<os
majorVersion
minorVersion
buildNumber
servicePackMajor
servicePackMinor
productType
suiteType
/>
</osVersionInfo>
</dependentOS>
<dependentAssembly
dependencyType
allowDelayedBinding
group
codeBase
size
>
<assemblyIdentity
name
version
processorArchitecture
language
>
<hash>
<dsig:Transforms>
<dsig:Transform
Algorithm
/>
</dsig:Transforms>
<dsig:DigestMethod />
<dsig:DigestValue>
</dsig:DigestValue>
</hash>
</assemblyIdentity>
</dependentAssembly>
</dependency>
Öğeler ve Öznitelikler
dependency öğesi gereklidir. Aynı uygulama bildiriminde birden çok dependency örneği olabilir.
dependency öğesi özniteliklere sahip değildir ve aşağıdaki alt öğeleri içerir.
dependentOS
İsteğe Bağlı. osVersionInfo öğesini içerir. dependentOS Ve dependentAssembly öğeleri dışlar: birini veya diğerini gerekir için kayıtlı bir dependency öğesi, ancak her ikisini birden değil.
dependentOS aşağıdaki öznitelikleri destekler.
Öznitelik |
Description |
---|---|
supportUrl |
İsteğe Bağlı. Bağımlı platform için destek URL'sini belirtir. Gerekli platform bulunursa, bu URL kullanıcıya gösterilir. |
description |
İsteğe Bağlı. Kullanıcı tarafından okunabilen bir formda, dependentOS tarafından tanımlanan işletim sistemini açıklar. |
osVersionInfo
Gerekli. Bu öğe dependentOS öğesinin alt öğesidir ve os öğesini içerir. Bu öğe özniteliklere sahip değildir.
is
Gerekli. Bu öğe osVersionInfo öğesinin alt öğesidir. Bu öğenin öznitelikleri şunlardır:
Öznitelik |
Description |
---|---|
majorVersion |
Gerekli. İşletim Sisteminin ana sürüm numarasını belirtir. |
minorVersion |
Gerekli. İşletim Sisteminin ikincil sürüm numarasını belirtir. |
buildNumber |
Gerekli. İşletim Sisteminin yapı numarasını belirtir. |
servicePackMajor |
Gerekli. İşletim Sisteminin hizmet paketi birincil numarasını belirtir. |
servicePackMinor |
İsteğe Bağlı. İşletim Sisteminin hizmet paketi ikincil numarasını belirtir. |
productType |
İsteğe Bağlı. Ürün türü değerini tanımlar. Geçerli değerler şunlardır: server, workstation, ve domainController. Örneğin, Windows 2000 Professional için bu öznitelik değeri workstation'dir. |
suiteType |
İsteğe Bağlı. Sistem üzerinde kullanılabilir bir ürün paketini veya sistemin yapılandırma türünü tanımlar. Geçerli değerler şunlardır: backoffice, blade, datacenter, enterprise, home, professional, smallbusiness, smallbusinessRestricted, ve terminal. Örneğin, Windows 2000 Professional için bu öznitelik değeri professional'dir. |
dependentAssembly
İsteğe Bağlı. assemblyIdentity öğesini içerir. dependentOS Ve dependentAssembly öğeleri dışlar: birini veya diğerini gerekir için kayıtlı bir dependency öğesi, ancak her ikisini birden değil.
dependentAssembly öğesi aşağıdaki özniteliklere sahiptir.
Öznitelik |
Description |
---|---|
dependencyType |
Gerekli. Bağımlılık türünü belirtir. Geçerli değerler şunlardır: preprequisite ve install. install derlemesi ClickOnce uygulamasının parçası olarak kurulur. ClickOnce uygulamayı kurmadan önce, bir prerequisite derlemesi genel derleme ön belleğinde (GAC) mevcut olmalıdır. |
allowDelayedBinding |
Gerekli. Derlemenin çalışma zamanında program aracılığıyla yüklenebilir olup olmadığını belirtir. |
group |
İsteğe Bağlı. dependencyType özniteliği install şeklinde ayarlanmışsa, yalnızca isteğe bağlı kurulan adlandırılmış bir grup derlemeyi belirler. Daha fazla bilgi için bkz. İzlenecek yol: Derlemeler ClickOnce dağıtımı Designer'ı kullanarak API ile isteğe bağlı yükleme. framework şeklinde ayarlanmışsa ve dependencyType özniteliği prerequisite olarak ayarlanmışsa, derlemeyi .NET Framework'ün bir parçası olarak belirler. .NET Framework 4 ve sonraki sürümler üzerinde kurduğunuz zaman, genel derleme önbelleği (GAC) bu derleme için işaretlenmemiştir. |
codeBase |
dependencyType özniteliği install olarak ayarlandığında gerekli. Bağımlı derleme yolu. Mutlak bir yol veya bildirim kodunun temeline bağlı bir yol olabilir. Derleme bildiriminin geçerli olması için, bu yol geçerli bir URI olmalıdır. |
size |
dependencyType özniteliği install olarak ayarlandığında gerekli. Bağımlı derlemenin bayt cinsinden boyutu. |
assemblyIdentity
Gerekli. Bu öğe dependentAssembly öğesinin alt öğesi ve aşağıdaki özniteliklere sahiptir.
Öznitelik |
Description |
---|---|
name |
Gerekli. Uygulamanın adını tanımlar. |
version |
Gerekli. Uygulamanın sürüm numarasını aşağıdaki biçimde belirler: ana.alt düzey.yapı.düzeltme |
publicKeyToken |
İsteğe Bağlı. İmzalanan derleme veya uygulama altında bulunan ortak anahtarın SHA-1 karma değerinin son 8 baytını temsil eden 16 karakter onaltılık dizeyi belirtir. Kataloğu imzalamak için kullanılan ortak anahtar 2048 bit veya daha fazla olması gerekir. |
processorArchitecture |
İsteğe Bağlı. İşlemci belirtir. Geçerli değerler şunlardır: 32-Bit Windows için x86 ve 64 bit Windows için I64 |
language |
İsteğe Bağlı. EN-US gibi, derlemeye ait iki bölümlü dil kodları tanımlar. |
hash
hash öğesi, assemblyIdentity öğ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.
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 |
Description |
---|---|
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 |
Description |
---|---|
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.
Notlar
Uygulama tarafından kullanılan tüm derlemelere karşılık gelen dependency öğesi olması gerekir. Bağımlı derlemeler genel derleme önbelleğinde platform derlemesi olarak önceden kurulmak zorunda olan derlemeleri içermez.
Örnek
Aşağıdaki kod ClickOnce uygulama bildiriminde dependency öğelerini gösterir. Bu kod örneği ClickOnce Uygulama Bildirimi konusu için sağlanan daha büyük bir örneğin bir bölümüdür.
<dependency>
<dependentOS>
<osVersionInfo>
<os
majorVersion="4"
minorVersion="10"
buildNumber="0"
servicePackMajor="0" />
</osVersionInfo>
</dependentOS>
</dependency>
<dependency>
<dependentAssembly
dependencyType="preRequisite"
allowDelayedBinding="true">
<assemblyIdentity
name="Microsoft.Windows.CommonLanguageRuntime"
version="4.0.20506.0" />
</dependentAssembly>
</dependency>
<dependency>
<dependentAssembly
dependencyType="install"
allowDelayedBinding="true"
codebase="MyApplication.exe"
size="4096">
<assemblyIdentity
name="MyApplication"
version="1.0.0.0"
language="neutral"
processorArchitecture="x86" />
<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>DpTW7RzS9IeT/RBSLj54vfTEzNg=</dsig:DigestValue>
</hash>
</dependentAssembly>
</dependency>