Freigeben über

<dependency>-Element (ClickOnce-Anwendung)

Aktualisiert: Juli 2008

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

<dependency>
   <dependentOS
      supportURL
      description
   >
      <osVersionInfo>
         <os
            majorVersion
            minorVersion
            buildNumber
            servicePackMajor
            servicePackMinor
            productType
            suiteType
         /> 
      </osVersionInfo>
   </dependentOS>
   <dependentAssembly
      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 gibt möglicherweise mehrere Instanzen von dependency im gleichen Anwendungsmanifest.

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

dependentOS

Optional. Enthält das osVersionInfo-Element. Das dependentOS-Element und das dependentAssembly-Element schließen sich gegenseitig aus, d. h., für ein dependency-Element muss eines von beiden vorhanden sein, beide dürfen jedoch nicht vorhanden sein.

dependentOS unterstützt die folgenden Attribute:

Attribute

Beschreibung

supportUrl

Optional. Gibt eine Support-URL für die abhängige Plattform an. Diese URL wird dem Benutzer angezeigt, wenn die erforderliche Plattform gefunden wird.

description

Optional. Beschreibt das mit dem dependentOS-Element beschriebene Betriebssystem in lesbarem Format.

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 verfügt über die folgenden Attribute.

Attribute

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 Service Pack-Hauptversionsnummer des Betriebssystems an.

servicePackMinor

Optional. Gibt die Service Pack-Nebenversionsnummer des Betriebssystems an.

productType

Optional. Identifiziert den Wert für den Produkttyp. Gültige Werte sind server, workstation und domainController. Bei Windows 2000 Professional z. B. lautet dieser Attributwert workstation.

suiteType

Optional. Identifiziert eine Produktsuite, die auf dem System verfügbar ist, oder den Konfigurationstyp des Systems. Gültige Werte sind backoffice, blade, datacenter, enterprise, home, professional, smallbusiness, smallbusinessRestricted und terminal. Bei Windows 2000 Professional z. B. lautet dieser Attributwert professional.

dependentAssembly

Optional. Enthält das assemblyIdentity-Element. Das dependentOS-Element und das dependentAssembly-Element schließen sich gegenseitig aus, d. h., für ein dependency-Element muss eines von beiden vorhanden sein, beide dürfen jedoch nicht vorhanden sein.

dependentAssembly verfügt über folgende Attribute.

Attribute

Beschreibung

 
codeBase

Erforderlich. Der Pfad zu der von dieser Assembly dargestellten Assembly. Kann entweder ein absoluter Pfad oder ein zur CodeBase des Manifests relativer Pfad sein. Dieser Pfad muss ein gültiger URI sein, damit das Assemblymanifest gültig ist.

size

Erforderlich. Die Größe der abhängigen Assembly in Bytes.

assemblyIdentity

Erforderlich. Dieses Element ist ein untergeordnetes Element des dependentAssembly-Elements und verfügt über die folgenden Attribute.

Attribute

Beschreibung

name

Erforderlich. Identifiziert den Namen der Anwendung.

version

Erforderlich. Gibt die Versionsnummer der Anwendung im folgenden Format an: major.minor.build.revision

publicKeyToken

Optional. Gibt eine aus 16 Zeichen bestehende hexadezimale Zeichenfolge an, die die letzten 8 Bytes des SHA-1-Hashwerts des öffentlichen Schlüssels darstellt, der zum Signieren der Anwendung oder der Assembly verwendet wird. Der öffentliche Schlüssel, der zum Signieren des Katalogs verwendet wird, muss mindestens 2048 Bits groß sein.

processorArchitecture

Optional. Gibt den Prozessor an. Die gültigen Werte sind x86 für 32-Bit-Windows und I64 für 64-Bit-Windows.

language

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 als Sicherheitsüberprüfung einen algorithmischen Hash aller Dateien in einer Anwendung, um sicherzustellen, dass keine der Dateien nach der Bereitstellung geändert wurde. Wenn das hash-Element nicht enthalten ist, wird die Überprüfung nicht durchgeführt. Aus diesem Grund wird das Weglassen 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:Transforms

Das dsig:Transform-Element ist ein erforderliches untergeordnetes Element des dsig:Transforms-Elements. Das dsig:Transform-Element verfügt über die folgenden Attribute.

Attribute

Beschreibung

Algorithm

Der Algorithmus, der zum Berechnen des Digests für diese Datei verwendet wird. Derzeit wird von ClickOnce nur ein Wert verwendet, nämlich urn:schemas-microsoft-com:HashTransforms.Identity.

dsig:DigestMethod

Das dsig:DigestMethod-Element ist ein erforderliches untergeordnetes Element des hash-Elements. Das dsig:DigestMethod-Element verfügt über die folgenden Attribute.

Attribute

Beschreibung

Algorithm

Der Algorithmus, der zum Berechnen des Digests für diese Datei verwendet wird. Derzeit wird von ClickOnce nur ein Wert verwendet, nämlich 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. Sein Textwert ist der berechnete Hash für die angegebene Datei.

Hinweise

Alle von der Anwendung verwendeten Assemblys müssen ein entsprechendes dependency-Element aufweisen. Abhängige Assemblys umfassen keine Assemblys, die im globalen Assemblycache als Plattformassemblys vorinstalliert werden müssen.

Beispiel

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

<!-- This XML identifies a SpellingChecker assembly. -->
<dependency>
  <dependentAssembly codebase="SpellingChecker.dll" size="29696">
    <assemblyIdentity name="SpellingChecker" version="2.0.0.0" publicKeyToken="e8ed396099c4b4e9" processorArchitecture="msil" language="es-PE" />
    <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>2+33lqQoPphgov907Kfp1v4TZMw=</dsig:DigestValue>
    </hash>
  </dependentAssembly>
</dependency>

<!-- This XML describes an operating system dependency for the application. -->
<!--Microsoft Windows Operating System Platform Dependency-->
<dependency>
  <dependentOS supportUrl="https://www.microsoft.com" description="Microsoft Windows Operating System">
    <osVersionInfo>
      <os majorVersion="4" minorVersion="10" />
    </osVersionInfo>
  </dependentOS>
</dependency>

Siehe auch

Referenz

ClickOnce-Anwendungsmanifest

Änderungsprotokoll

Date

Versionsgeschichte

Grund

Juli 2008

Optionale Informationen über das hash-Element hinzugefügt.

Informationsergänzung.
  • Last updated on