<dependency>-Element (ClickOnce-Anwendung)

Artikel
03/15/2023

Identifiziert eine Plattform- oder Assemblyabhängigkeit, die für die Anwendung erforderlich ist.

Syntax


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

Elemente und Attribute

Das dependency-Element ist erforderlich. Es kann mehrere Instanzen von dependency im selben Anwendungsmanifest geben.

Das dependency-Element besitzt keine Attribute und enthält die folgenden untergeordneten Elemente.

dependentOS

Dies ist optional. Enthält das osVersionInfo-Element. Die dependentOS- und dependentAssembly-Elemente schließen sich gegenseitig aus: Das eine oder das andere Element muss für ein dependency-Element vorhanden sein, nicht aber beide Elemente.

dependentOS unterstützt die folgenden Attribute.

Attribut	BESCHREIBUNG
`supportUrl`	Dies ist optional. Gibt eine Support-URL für die abhängige Plattform an. Diese URL wird dem Benutzer angezeigt, wenn die erforderliche Plattform gefunden wurde.
`description`	Dies ist optional. Beschreibt in Klartextform das Betriebssystem, das durch das `dependentOS`-Element beschrieben wird.

osVersionInfo

Erforderlich. Dieses Element ist ein untergeordnetes Element des dependentOS -Elements und enthält das os -Element. Dieses Element weist keine Attribute auf.

os

Erforderlich. Dieses Element ist ein untergeordnetes Element des osVersionInfo -Elements. Dieses Element weist folgende Attribute auf.

Attribut	BESCHREIBUNG
`majorVersion`	Erforderlich. Gibt die Hauptversionsnummer des Betriebssystems an.
`minorVersion`	Erforderlich. Gibt die Nebenversionsnummer des Betriebssystems an.
`buildNumber`	Erforderlich. Gibt die Buildnummer des Betriebssystems an.
`servicePackMajor`	Erforderlich. Gibt die Hauptversionsnummer des Service Packs des Betriebssystems an.
`servicePackMinor`	Dies ist optional. Gibt die Nebenversionsnummer des Service Packs des Betriebssystems an.
`productType`	Dies ist optional. Gibt den Wert des Produkttyps an. Gültige Werte sind `server`, `workstation` und `domainController`. Für Windows 10 lautet dieser Attributwert beispielsweise `workstation`.
`suiteType`	Optional. Gibt eine auf dem System verfügbare Produktsuite oder den Konfigurationstyp des Systems an. Gültige Werte sind `backoffice`, `blade`, `datacenter`, `enterprise`, `home`, `professional`, `smallbusiness`, `smallbusinessRestricted` und `terminal`. Für Windows 2000 Professional lautet dieser Attributwert beispielsweise `professional`.

dependentAssembly

Dies ist optional. Enthält das assemblyIdentity-Element. Die dependentOS- und dependentAssembly-Elemente schließen sich gegenseitig aus: Das eine oder das andere Element muss für ein dependency-Element vorhanden sein, nicht aber beide Elemente.

dependentAssembly besitzt die folgenden Attribute.

Attribut	BESCHREIBUNG
`dependencyType`	Erforderlich. Gibt den Abhängigkeitstyp an. Gültige Werte sind `prerequisite` und `install`. Eine `install`-Assembly wird als Teil der ClickOnce-Anwendung installiert. Eine `prerequisite`-Assembly muss im globalen Assemblycache (GAC) vorhanden sein, bevor die ClickOnce-Anwendung installiert werden kann.
`allowDelayedBinding`	Erforderlich. Gibt an, ob die Assembly programmgesteuert zur Laufzeit geladen werden kann.
`group`	Dies ist optional. Gibt eine benannte Gruppe von Assemblys an, die nur bei Bedarf installiert werden,wenn das `dependencyType`-Attribut auf `install` festgelegt ist. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Herunterladen von Assemblys bei Bedarf mit der API für die ClickOnce-Bereitstellung unter Verwendung des Designers. Wenn es auf `framework` festgelegt ist und das `dependencyType`-Attribut auf `prerequisite` festgelegt ist, wird die Assembly als Teil von .NET Framework festgelegt. Der globale Assemblycache (GAC) wird bei der Installation in .NET Framework 4 und höheren Versionen nicht auf diese Assembly überprüft.
`codeBase`	Erforderlich, wenn das `dependencyType`-Attribut auf `install` festgelegt ist. Der Pfad zur abhängigen Assembly. Kann entweder ein absoluter Pfad oder ein Pfad relativ zur Codebasis des Manifests sein. Dieser Pfad muss ein gültiger URI sein, damit das Assemblymanifest gültig ist.
`size`	Erforderlich, wenn das `dependencyType`-Attribut auf `install` festgelegt ist. Die Größe der abhängigen Assembly in Bytes.

assemblyIdentity

Erforderlich. Dieses Element ist ein untergeordnetes Element des dependentAssembly -Elements und weist folgende Attribute auf.

Attribut	BESCHREIBUNG
`name`	Erforderlich. Gibt den Namen der Anwendung an.
`version`	Erforderlich. Gibt die Versionsnummer der Anwendung im folgenden Format an: `major.minor.build.revision`
`publicKeyToken`	Dies ist optional. Gibt eine hexadezimale Zeichenfolge mit 16 Zeichen an, die die letzten 8 Bytes des `SHA-1`-Hashwerts des öffentlichen Schlüssels darstellt, unter dem die Anwendung oder Assembly signiert ist. Der öffentliche Schlüssel, der zum Signieren des Katalogs verwendet wird, muss mindestens 2.048 Bit lang sein.
`processorArchitecture`	Dies ist optional. Gibt den Prozessor an. Die gültigen Werte sind `x86` für 32-Bit-Windows und `I64` für 64-Bit-Windows.
`language`	Dies ist optional. Identifiziert die zweiteiligen Sprachcodes der Assembly, z. B. „EN-US“.

hash

Das hash-Element ist ein optionales untergeordnetes Element des assemblyIdentity-Elements. Das hash -Element weist keine Attribute auf.

ClickOnce verwendet einen algorithmischen Hashwert aller Dateien in einer Anwendung als Sicherheitsüberprüfung, um sicherzustellen, dass keine der Dateien nach der Bereitstellung geändert wurde. Wenn das hash-Element nicht enthalten ist, wird diese Überprüfung nicht durchgeführt. Daher wird das Auslassen des hash-Elements nicht empfohlen.

dsig:Transforms

Das dsig:Transforms-Element ist ein erforderliches untergeordnetes Element des hash-Elements. Das dsig:Transforms -Element weist keine Attribute auf.

dsig:Transform

Das dsig:Transform-Element ist ein erforderliches untergeordnetes Element des dsig:Transforms-Elements. Das dsig:Transform -Element weist folgende Attribute auf.

Attribut	BESCHREIBUNG
`Algorithm`	Der Algorithmus, der zum Berechnen des Digests für diese Datei verwendet wird. Der derzeit einzige Wert, der von ClickOnce verwendet wird, ist `urn:schemas-microsoft-com:HashTransforms.Identity`.

dsig:DigestMethod

Das dsig:DigestMethod-Element ist ein erforderliches untergeordnetes Element des hash-Elements. Das dsig:DigestMethod -Element weist folgende Attribute auf.

Attribut	BESCHREIBUNG
`Algorithm`	Der Algorithmus, der zum Berechnen des Digests für diese Datei verwendet wird. Der derzeit einzige Wert, der von ClickOnce verwendet wird, ist `http://www.w3.org/2000/09/xmldsig#sha1`.

dsig:DigestValue

Das dsig:DigestValue-Element ist ein erforderliches untergeordnetes Element des hash-Elements. Das dsig:DigestValue -Element weist keine Attribute auf. Der Textwert ist der berechnete Hashwert für die angegebene Datei.

Hinweise

Alle Assemblys, die von Ihrer Anwendung verwendet werden, müssen über ein entsprechendes dependency-Element verfügen. Abhängige Assemblys enthalten keine Assemblys, die im globalen Assemblycache als Plattformassemblys vorinstalliert werden müssen.

Beispiel

Im folgenden Codebeispiel werden dependency-Elemente in einem ClickOnce-Anwendungsmanifest gezeigt. Dieses Codebeispiel ist Teil eines umfangreicheren Beispiels, das für das Thema ClickOnce-Anwendungsmanifest bereitgestellt wird.

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