Freigeben über


<dependency>-Element (ClickOnce-Anwendung)

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>

Weitere Informationen