<dependency> öğesi (ClickOnce uygulaması)

Makale
01/12/2024

Uygulama için gereken bir platform veya derleme bağımlılığını tanımlar.

Sözdizimi


      <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 örneği dependency olabilir.

öğesinin dependency özniteliği yoktur ve aşağıdaki alt öğeleri içerir.

dependentOS

isteğe bağlı. osVersionInfo öğesini içerir. dependentOS ve dependentAssembly öğeleri birbirini dışlar: bir öğe için biri dependency veya diğeri bulunmalıdır, ancak her ikisini birden içermemelidir.

dependentOS aşağıdaki öznitelikleri destekler.

Öznitelik	Açıklama
`supportUrl`	isteğe bağlı. Bağımlı platform için bir destek URL'si belirtir. Gerekli platform bulunursa bu URL kullanıcıya gösterilir.
`description`	isteğe bağlı. öğesi tarafından `dependentOS` açıklanan işletim sistemini insan tarafından okunabilir biçimde açıklar.

osVersionInfo

Gerekli. Bu öğe öğesinin dependentOS alt öğesidir ve öğesini içerir os . Bu öğenin özniteliği yok.

Os

Gerekli. Bu öğe, öğesinin osVersionInfo alt öğesidir. Bu öğe aşağıdaki özniteliklere sahiptir.

Öznitelik	Açıklama
`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 derleme numarasını belirtir.
`servicePackMajor`	Gerekli. İşletim sisteminin hizmet paketi ana numarasını belirtir.
`servicePackMinor`	isteğe bağlı. İşletim sisteminin hizmet paketi ikincil numarasını belirtir.
`productType`	isteğe bağlı. Ürün türü değerini tanımlar. Geçerli değerler: `server`, `workstation` ve `domainController`. Örneğin, Windows 10 için bu öznitelik değeri şeklindedir `workstation`.
`suiteType`	isteğe bağlı. Sistemde veya sistemin yapılandırma türünde kullanılabilen bir ürün paketini tanımlar. Geçerli değerler : , , , , , , `professional`, `smallbusiness`, `smallbusinessRestricted`ve `terminal`. `homeenterprisedatacenterbladebackoffice` Örneğin, Windows 2000 Professional için bu öznitelik değeri şeklindedir `professional`.

Dependentassembly

isteğe bağlı. assemblyIdentity öğesini içerir. dependentOS ve dependentAssembly öğeleri birbirini dışlar: bir öğe için biri dependency veya diğeri bulunmalıdır, ancak her ikisini birden içermemelidir.

dependentAssembly aşağıdaki özniteliklere sahiptir.

Öznitelik	Açıklama
`dependencyType`	Gerekli. Bağımlılık türünü belirtir. Geçerli değerler: `prerequisite` ve `install`. ClickOnce `install` uygulamasının bir parçası olarak bir derleme yüklenir. `prerequisite` ClickOnce uygulamasının yüklenebilmesi için önce genel derleme önbelleğinde (GAC) bir derleme bulunmalıdır.
`allowDelayedBinding`	Gerekli. Derlemenin çalışma zamanında program aracılığıyla yüklenip yüklenemeyeceğini belirtir.
`group`	isteğe bağlı. `dependencyType` özniteliği olarak `install`ayarlanırsa, yalnızca isteğe bağlı olarak yüklenen adlandırılmış bir derleme grubu belirler. Daha fazla bilgi için bkz. İzlenecek Yol: Tasarım Aracı Kullanarak ClickOnce Dağıtım API'siyle İsteğe Bağlı Derlemeleri İndirme. olarak ayarlanırsa `framework` ve `dependencyType` özniteliği olarak `prerequisite`ayarlanırsa, derlemeyi .NET Framework'ün bir parçası olarak belirler. .NET Framework 4 ve sonraki sürümlerde yüklenirken genel derleme önbelleği (GAC) bu derleme için denetlenmiyor.
`codeBase`	`dependencyType` özniteliği olarak ayarlandığında `install`gereklidir. Bağımlı derlemenin yolu. Mutlak bir yol veya bildirimin kod tabanına göre bir yol olabilir. Derleme bildiriminin geçerli olması için bu yolun geçerli bir URI olması gerekir.
`size`	`dependencyType` özniteliği olarak ayarlandığında `install`gereklidir. Bağımlı derlemenin bayt cinsinden boyutu.

Assemblyıdentity

Gerekli. Bu öğe öğesinin dependentAssembly alt öğesidir ve aşağıdaki özniteliklere sahiptir.

Öznitelik	Açıklama
`name`	Gerekli. Uygulamanın adını tanımlar.
`version`	Gerekli. Uygulamanın sürüm numarasını aşağıdaki biçimde belirtir: `major.minor.build.revision`
`publicKeyToken`	isteğe bağlı. Uygulamanın veya derlemenin imzalandığı ortak anahtarın karma değerinin `SHA-1` son 8 baytını temsil eden 16 karakterlik onaltılık dizeyi belirtir. Kataloğu imzalamak için kullanılan ortak anahtar 2048 bit veya daha fazla olmalıdır.
`processorArchitecture`	isteğe bağlı. İşlemciyi belirtir. Geçerli değerler `x86` 32 bit Windows ve `I64` 64 bit Windows içindir.
`language`	isteğe bağlı. Derlemenin EN-US gibi iki parçalı dil kodunu tanımlar.

hash

hash öğesi, öğesinin assemblyIdentity 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.

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

Uygulamanız tarafından kullanılan tüm derlemelerin karşılık gelen dependency bir öğesi olmalıdır. Bağımlı derlemeler, platform derlemeleri olarak genel derleme önbelleğine önceden yüklenmesi gereken derlemeleri içermez.

Örnek

Aşağıdaki kod örneği, ClickOnce uygulama bildirimindeki öğeleri gösterir dependency . Bu kod örneği, ClickOnce Uygulama Bildirimi konusu için sağlanan daha büyük bir örneğin parçası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>

Aracılığıyla paylaş