Sdílet prostřednictvím


<dependency> – element (aplikace ClickOnce)

Identifikuje závislost platformy nebo sestavení, která je vyžadována pro aplikaci.

Syntaxe


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

Prvky a atributy

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

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

dependentOS

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

dependentOS podporuje následující atributy.

Atribut Popis
supportUrl Nepovinné. Určuje adresu URL podpory pro závislou platformu. Tato adresa URL se uživateli zobrazí, pokud se najde požadovaná platforma.
description Nepovinné. Popisuje operační systém popsaný elementem dependentOS v čitelné podobě.

osVersionInfo

Povinný: Tento prvek je podřízený prvek dependentOS a obsahuje os prvek. Tento prvek nemá žádné atributy.

Os

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

Atribut Popis
majorVersion Požadováno. Určuje číslo hlavní verze operačního systému.
minorVersion Povinný: Určuje číslo podverze operačního systému.
buildNumber Povinný: Určuje číslo buildu operačního systému.
servicePackMajor Povinný: Určuje hlavní číslo aktualizace Service Pack operačního systému.
servicePackMinor Nepovinné. Určuje podverze aktualizace Service Pack operačního systému.
productType Nepovinné. Identifikuje hodnotu typu produktu. Platné hodnoty jsou server, workstation a domainController. Například pro Windows 10 je tato hodnota atributu workstation.
suiteType Nepovinné. Identifikuje sadu produktů dostupnou v systému nebo typ konfigurace systému. Platné hodnoty jsou backoffice, , blade, datacenter, homeenterprisesmallbusinessprofessional, , , smallbusinessRestricted, a .terminal Například pro Systém Windows 2000 Professional je tato hodnota atributu professional.

dependentAssembly

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

dependentAssembly má následující atributy.

Atribut Popis
dependencyType Požadováno. Určuje typ závislosti. Platné hodnoty jsou prerequisite a install. Sestavení install je nainstalováno jako součást aplikace ClickOnce. Před prerequisite instalací aplikace ClickOnce musí být sestavení v globální mezipaměti sestavení (GAC).
allowDelayedBinding Povinný: Určuje, zda lze sestavení načíst programově za běhu.
group Nepovinné. dependencyType Pokud je atribut nastaven na install, určuje pojmenovanou skupinu sestavení, která se instalují pouze na vyžádání. Další informace naleznete v tématu Návod: Stahování sestavení na vyžádání pomocí rozhraní API nasazení ClickOnce pomocí Návrháře.

Pokud je nastavena framework na a dependencyType atribut je nastaven na prerequisite, určuje sestavení jako součást rozhraní .NET Framework. Při instalaci na rozhraní .NET Framework 4 a novějších verzí se pro toto sestavení nekontroluje globální mezipaměť sestavení (GAC).
codeBase Požadováno, pokud dependencyType je atribut nastaven na install. Cesta ke závislému sestavení. Může to být absolutní cesta nebo cesta vzhledem k základu kódu manifestu. Tato cesta musí být platným identifikátorem URI, aby manifest sestavení byl platný.
size Požadováno, pokud dependencyType je atribut nastaven na install. Velikost závislého sestavení vbajchch

Assemblyidentity

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

Atribut Popis
name Požadováno. Určuje 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 šestnáctkový řetězec 16 znaků, který představuje posledních 8 bajtů SHA-1 hodnoty hash veřejného klíče, pod kterým je aplikace nebo sestavení podepsána. Veřejný klíč použitý k podepsání katalogu musí být 2048 bitů nebo více.
processorArchitecture Nepovinné. Určuje procesor. Platné hodnoty platí x86 pro 32bitovou verzi Windows a I64 pro 64bitovou verzi Windows.
language Nepovinné. Identifikuje dva kódy jazyka, například EN-US, sestavení.

hash

Prvek hash je volitelná podřízená položka elementu assemblyIdentity . Element hash nemá žádné atributy.

ClickOnce používá algoritmus hash všech souborů v aplikaci jako kontrolu zabezpečení, aby se zajistilo, že se po nasazení žádné soubory nezměnily. hash Pokud prvek není součástí, nebude tato kontrola provedena. Proto se nedoporučuje vynechat hash prvek.

dsig:Transforms

Prvek dsig:Transforms je povinný podřízený prvek hash . Element dsig:Transforms nemá žádné atributy.

dsig:Transform

Prvek dsig:Transform je povinný podřízený prvek dsig:Transforms . Element dsig:Transform má následující atributy.

Atribut Popis
Algorithm Algoritmus použitý k výpočtu hodnoty hash pro tento soubor. V současné době je jediná hodnota používaná technologií ClickOnce urn:schemas-microsoft-com:HashTransforms.Identity.

dsig:DigestMethod

Prvek dsig:DigestMethod je povinný podřízený prvek hash . Element dsig:DigestMethod má následující atributy.

Atribut Popis
Algorithm Algoritmus použitý k výpočtu hodnoty hash pro tento soubor. V současné době je jediná hodnota používaná technologií ClickOnce http://www.w3.org/2000/09/xmldsig#sha1.

dsig:DigestValue

Prvek dsig:DigestValue je povinný podřízený prvek hash . Element dsig:DigestValue nemá žádné atributy. Jeho textová hodnota je vypočítaná hodnota hash pro zadaný soubor.

Poznámky

Všechna sestavení používaná vaší aplikací musí mít odpovídající dependency prvek. Závislá sestavení nezahrnují sestavení, která musí být předinstalována v globální mezipaměti sestavení jako sestavení platformy.

Příklad

Následující příklad kódu znázorňuje dependency prvky v manifestu aplikace ClickOnce. Tento příklad kódu je součástí většího příkladu zadaného pro téma manifestu 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é