<dependency> Prvek (aplikace ClickOnce)

Článek
03/04/2013

Určuje platformu nebo sestavení závislosti, které je vyžadováno pro aplikaci.

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

Atributy a prvky

Prvek dependency je povinný.Může existovat více instancí dependency ve stejném manifestu aplikace.

Prvek dependency nemá žádné atributy a obsahuje následující podřízené prvky.

dependentOS

Nepovinné.Obsahuje prvek osVersionInfo.dependentOS a dependentAssembly prvky, které se vzájemně vylučují: musí existovat jeden nebo druhý dependency prvek, ale ne obojí.

dependentOS podporuje následující atributy.

Atribut	Description
supportUrl	Nepovinné.Určuje adresu URL podpory pro závislou platformu.Tato adresa URL je zobrazena uživateli je-li nalezena požadovaná platforma.
description	Nepovinné.Ve formátu srozumitelném pro uživatele popisuje operační systém popsaný v prvku dependentOS.

osVersionInfo

Povinné.Tento prvek je podřízeným prvkem dependentOS a obsahuje prvek os.Tento prvek neobsahuje žádné atributy.

OS

Povinné.Tento prvek je podřízeným prvku osVersionInfo. Tento prvek má následující atributy.

Atribut	Description
majorVersion	Povinné.Určuje hlavní číslo verze operačního systému.
minorVersion	Povinné.Určuje číslo podverze operačního systému.
buildNumber	Povinné.Určuje číslo sestavení operačního systému.
servicePackMajor	Povinné.Určuje hlavní číslo aktualizace Service Pack operačního systému.
servicePackMinor	Nepovinné.Určuje číslo podverze aktualizace Service Pack operačního systému.
productType	Nepovinné.Určuje hodnotu typu produktu.Platné hodnoty jsou server, workstation a domainController.Například pro systém Windows 2000 Professional, hodnota je tohoto atributu workstation.
suiteType	Nepovinné.Identifikuje produktovou sadu, která je k dispozici v systému nebo typ konfigurace systému.Platné hodnoty jsou backoffice, blade, datacenter, enterprise, home, professional, smallbusiness, smallbusinessRestricted a terminal.Například pro systém Windows 2000 Professional, je hodnota tohoto atributu professional.

dependentAssembly

Nepovinné.Obsahuje prvek assemblyIdentity.dependentOS a dependentAssembly prvky, které se vzájemně vylučují: musí existovat jeden nebo druhý dependency prvek, ale ne obojí.

dependentAssembly obsahuje následující atributy.

Atribut	Description
dependencyType	Povinné.Určuje typ závislosti.Platné hodnoty jsou preprequisite a install.Sestavení install je nainstalováno jako součást aplikace ClickOnce.Sestavení prerequisite musí být přítomny v globální mezipaměti sestavení (GAC) před instalací aplikace ClickOnce.
allowDelayedBinding	Povinné.Určuje, zda může být sestavení načteno programově za běhu.
group	Nepovinné.Pokud je atribut dependencyType nastaven na install, označí jmenovanou skupinu sestavení, která je nainstaluje pouze na požádání. Další informace naleznete v tématu Názorný postup: Stahování sestavení na požádání s nasazení technologie ClickOnce rozhraní API pomocí Návrháře. Pokud je nastaven na framework a atribut dependencyType je nastaven na prerequisite, označí sestavení jako součást rozhraní .NET Framework. Globální mezipaměť sestavení (GAC) není pro toto sestavení označena při instalaci v .NET Framework 4 a novějších verzích.
codeBase	Požadováno, pokud je atribut dependencyType nastaven na hodnotu install. Cesta k závislému sestavení.Může být buď absolutní cesta nebo cesta relativní k základu kódu manifestu.Tato cesta musí být platný identifikátor URI, aby byl manifest sestavení platný.
size	Požadováno, pokud je atribut dependencyType nastaven na hodnotu install. Velikost závislého sestavení v bajtech.

assemblyIdentity

Povinné.Tento prvek je podřízený prvku dependentAssembly a má následující atributy.

Atribut	Description
name	Povinné.Identifikuje název aplikace.
version	Povinné.Určuje číslo verze aplikace v následujícím formátu: major.minor.build.revision
publicKeyToken	Nepovinné.Určuje 16-znakový šestnáctkový řetězec, který představuje posledních 8 bajtů SHA-1 hodnoty hash veřejného klíče, pod kterým jsou aplikace nebo sestavení podepsány.Veřejný klíč použitý k podpisu katalogu musí mít délku 2048 bitů nebo více.
processorArchitecture	Nepovinné.Určuje procesor.Platné hodnoty jsou x86 pro 32bitové verze Windows a I64 pro 64bitové verze Windows.
language	Nepovinné.Určuje dvě části kódů jazyků sestavení, jako jsou EN-US.

hodnota hash

Prvek hash je volitelným podřízeným prvku assemblyIdentity. Prvek hash neobsahuje žádné atributy.

ClickOnce aplikace používá algorithmickou hodnotu hash všech souborů v aplikaci jako kontrolu zabezpečení, aby žádný ze souborů nebyl změněn po nasazení. Pokud prvek hash není zahrnut, nebude provedena kontrola. Proto není vynechání prvku hash doporučeno.

dsig:Transforms

Prvek dsig:Transforms je vyžadovaným podřízeným prvku hash. Prvek dsig:Transforms neobsahuje žádné atributy.

dsig:Transform

Prvek dsig:Transform je vyžadovaným podřízeným prvku dsig:Transforms.Prvek dsig:Transform má následující atributy.

Atribut	Description
Algorithm	Algoritmus použitý pro výpočet algoritmu Digest pro tento soubor.Aktuálně jedinou používanou hodnotou ClickOnce je pouze urn:schemas-microsoft-com:HashTransforms.Identity.

dsig:DigestMethod

Prvek dsig:DigestMethod je vyžadovaným podřízeným prvku hash.Prvek dsig:DigestMethod má následující atributy.

Atribut	Description
Algorithm	Algoritmus použitý pro výpočet algoritmu Digest pro tento soubor.Aktuálně jedinou používanou hodnotou ClickOnce je pouze http://www.w3.org/2000/09/xmldsig#sha1.

dsig:DigestValue

Prvek dsig:DigestValue je vyžadovaným podřízeným prvku hash.Prvek dsig:DigestValue neobsahuje žádné atributy.Jeho textová hodnota je vypočítanou hodnotou hash pro zadaný soubor.

Poznámky

Všechny sestavení, které používá vaše aplikace musí mít odpovídající prvek dependency.Závislé sestavení nezahrnují sestavení, která musí být předem nainstalována do globální mezipaměti sestavení (GAC) jako sestavení platformy.

Příklad

Následující příklad kódu ukazuje prvky dependency v manifestu aplikace ClickOnce.Tento příklad kódu je součástí většího příkladu určeného pro téma Manifest aplikace ClickOnce.

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

Viz také

Referenční dokumentace

Manifest aplikace ClickOnce

<dependency> Prvek (nasazení ClickOnce)

Sdílet prostřednictvím