<Dependency> , élément (application ClickOnce)<dependency> element (ClickOnce application)

Identifie une dépendance de plateforme ou d’assembly requise pour l’application.Identifies a platform or assembly dependency that is required for the application.

SyntaxeSyntax


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

Éléments et attributsElements and attributes

L' dependency élément est obligatoire.The dependency element is required. Il peut y avoir plusieurs instances dependency de dans le même manifeste d’application.There may be multiple instances of dependency in the same application manifest.

L' dependency élément n’a pas d’attributs et contient les éléments enfants suivants.The dependency element has no attributes, and contains the following child elements.

avec dépendantsdependentOS

Optionnel.Optional. Contient l' osVersionInfo élément.Contains the osVersionInfo element. Les dependentOS éléments dependentAssembly et s’excluent mutuellement : l’un ou l’autre doit exister dependency pour un élément, mais pas les deux.The dependentOS and dependentAssembly elements are mutually exclusive: one or the other must exist for a dependency element, but not both.

dependentOSprend en charge les attributs suivants.dependentOS supports the following attributes.

AttributAttribute DescriptionDescription
supportUrl Optionnel.Optional. Spécifie une URL de prise en charge pour la plateforme dépendante.Specifies a support URL for the dependent platform. Cette URL est indiquée à l’utilisateur si la plateforme requise est trouvée.This URL is shown to the user if the required platform is found.
description Optionnel.Optional. Décrit, dans un format lisible par l’utilisateur, le système d’exploitation dependentOS décrit par l’élément.Describes, in human-readable form, the operating system described by the dependentOS element.

osVersionInfoosVersionInfo

Obligatoire.Required. Cet élément est un enfant de l’élément dependentOS et contient l’élément os .This element is a child of the dependentOS element and contains the os element. Cet élément n’a pas d’attributs.This element has no attributes.

osos

Obligatoire.Required. Cet élément est un enfant de l’élément osVersionInfo .This element is a child of the osVersionInfo element. Cet élément comprend les attributs suivants.This element has the following attributes.

AttributAttribute DescriptionDescription
majorVersion Obligatoire.Required. Spécifie le numéro de version principale du système d’exploitation.Specifies the major version number of the OS.
minorVersion Obligatoire.Required. Spécifie le numéro de version mineure du système d’exploitation.Specifies the minor version number of the OS.
buildNumber Obligatoire.Required. Spécifie le numéro de build du système d’exploitation.Specifies the build number of the OS.
servicePackMajor Obligatoire.Required. Spécifie le Service Pack numéro principal du système d’exploitation.Specifies the service pack major number of the OS.
servicePackMinor Optionnel.Optional. Spécifie le Service Pack numéro mineur du système d’exploitation.Specifies the service pack minor number of the OS.
productType Optionnel.Optional. Identifie la valeur du type de produit.Identifies the product type value. Les valeurs valides sont server, workstation et domainController.Valid values are server, workstation, and domainController. Par exemple, pour Windows 2000 professionnel, cette valeur d’attribut workstationest.For example, for Windows 2000 Professional, this attribute value is workstation.
suiteType Optionnel.Optional. Identifie une suite de produits disponible sur le système ou le type de configuration du système.Identifies a product suite available on the system, or the system's configuration type. Les valeurs valides sont backoffice, blade, datacenter, enterprise, home, professional, smallbusiness, smallbusinessRestricted et terminal.Valid values are backoffice, blade, datacenter, enterprise, home, professional, smallbusiness, smallbusinessRestricted, and terminal. Par exemple, pour Windows 2000 professionnel, cette valeur d’attribut professionalest.For example, for Windows 2000 Professional, this attribute value is professional.

dependentAssemblydependentAssembly

Optionnel.Optional. Contient l' assemblyIdentity élément.Contains the assemblyIdentity element. Les dependentOS éléments dependentAssembly et s’excluent mutuellement : l’un ou l’autre doit exister dependency pour un élément, mais pas les deux.The dependentOS and dependentAssembly elements are mutually exclusive: one or the other must exist for a dependency element, but not both.

dependentAssemblya les attributs suivants.dependentAssembly has the following attributes.

AttributAttribute DescriptionDescription
dependencyType Obligatoire.Required. Spécifie le type de dépendance.Specifies the dependency type. Les valeurs valides sont preprequisite et install.Valid values are preprequisite and install. Un install assembly est installé dans le cadre ClickOnceClickOnce de l’application.An install assembly is installed as part of the ClickOnceClickOnce application. Un prerequisite assembly doit être présent dans le global assembly cache (GAC) pour ClickOnceClickOnce que l’application puisse être installée.A prerequisite assembly must be present in the global assembly cache (GAC) before the ClickOnceClickOnce application can install.
allowDelayedBinding Obligatoire.Required. Spécifie si l’assembly peut être chargé par programmation au moment de l’exécution.Specifies whether the assembly can be loaded programmatically at run time.
group Optionnel.Optional. Si l' dependencyType attribut a la installvaleur, désigne un groupe nommé d’assemblys qui s’installent uniquement à la demande.If the dependencyType attribute is set to install, designates a named group of assemblies that only install on demand. Pour plus d’informations, consultez Procédure pas à pas : Téléchargement d’assemblys à la demande avec l’API de déploiement ClickOnce à l’aide du concepteur.For more information, see Walkthrough: Downloading Assemblies on Demand with the ClickOnce Deployment API Using the Designer.

Si la valeur framework est et dependencyType que l’attribut a prerequisitela valeur, désigne l’assembly dans le cadre du .NET Framework.If set to framework and the dependencyType attribute is set to prerequisite, designates the assembly as part of the .NET Framework. Le GAC (global assembly cache) n’est pas vérifié pour cet assembly lors de l’installation sur .NET Framework 4 et versions ultérieures.The global assemby cache (GAC) is not checked for this assembly when installing on .NET Framework 4 and later versions.
codeBase Obligatoire lorsque l' dependencyType attribut a la installvaleur.Required when the dependencyType attribute is set to install. Chemin d’accès à l’assembly dépendant.The path to the dependent assembly. Peut être un chemin d’accès absolu ou un chemin d’accès relatif à la base de code du manifeste.May be either an absolute path, or a path relative to the manifest's code base. Ce chemin d’accès doit être un URI valide pour que le manifeste d’assembly soit valide.This path must be a valid URI in order for the assembly manifest to be valid.
size Obligatoire lorsque l' dependencyType attribut a la installvaleur.Required when the dependencyType attribute is set to install. Taille de l’assembly dépendant, en octets.The size of the dependent assembly, in bytes.

assemblyIdentityassemblyIdentity

Obligatoire.Required. Cet élément est un enfant de l’élément dependentAssembly et comprend les attributs suivants.This element is a child of the dependentAssembly element and has the following attributes.

AttributAttribute DescriptionDescription
name Obligatoire.Required. Identifie le nom de l’application.Identifies the name of the application.
version Obligatoire.Required. Spécifie le numéro de version de l’application au format suivant :major.minor.build.revisionSpecifies the version number of the application in the following format: major.minor.build.revision
publicKeyToken Optionnel.Optional. Spécifie une chaîne hexadécimale de 16 caractères qui représente les 8 derniers octets SHA-1 de la valeur de hachage de la clé publique sous laquelle l’application ou l’assembly est signé.Specifies a 16-character hexadecimal string that represents the last 8 bytes of the SHA-1 hash value of the public key under which the application or assembly is signed. La clé publique utilisée pour signer le catalogue doit être de 2048 bits ou plus.The public key used to sign the catalog must be 2048 bits or more.
processorArchitecture Optionnel.Optional. Spécifie le processeur.Specifies the processor. Les valeurs valides x86 sont pour les fenêtres 32 bits I64 et pour Windows 64 bits.The valid values are x86 for 32-bit Windows and I64 for 64-bit Windows.
language Optionnel.Optional. Identifie les codes de langue en deux parties, tels que en-US, de l’assembly.Identifies the two part language codes, such as EN-US, of the assembly.

hashhash

L' hash élément est un enfant facultatif de l' assemblyIdentity élément.The hash element is an optional child of the assemblyIdentity element. L’élément hash ne comporte pas d’attributs.The hash element has no attributes.

ClickOnceClickOnceutilise un hachage algorithmique de tous les fichiers d’une application en tant que vérification de la sécurité, pour s’assurer qu’aucun des fichiers n’a été modifié après le déploiement.uses an algorithmic hash of all the files in an application as a security check, to ensure that none of the files were changed after deployment. Si l' hash élément n’est pas inclus, cette vérification ne sera pas effectuée.If the hash element is not included, this check will not be performed. Par conséquent, l’omission hash de l’élément n’est pas recommandée.Therefore, omitting the hash element is not recommended.

dsig:Transformsdsig:Transforms

L' dsig:Transforms élément est un enfant obligatoire de l' hash élément.The dsig:Transforms element is a required child of the hash element. L’élément dsig:Transforms ne comporte pas d’attributs.The dsig:Transforms element has no attributes.

dsig:Transformdsig:Transform

L' dsig:Transform élément est un enfant obligatoire de l' dsig:Transforms élément.The dsig:Transform element is a required child of the dsig:Transforms element. L’élément dsig:Transform a les attributs suivants.The dsig:Transform element has the following attributes.

AttributAttribute DescriptionDescription
Algorithm Algorithme utilisé pour calculer le Digest pour ce fichier.The algorithm used to calculate the digest for this file. Actuellement, la seule valeur utilisée ClickOnceClickOnce par urn:schemas-microsoft-com:HashTransforms.Identityest.Currently the only value used by ClickOnceClickOnce is urn:schemas-microsoft-com:HashTransforms.Identity.

dsig:DigestMethoddsig:DigestMethod

L' dsig:DigestMethod élément est un enfant obligatoire de l' hash élément.The dsig:DigestMethod element is a required child of the hash element. L’élément dsig:DigestMethod a les attributs suivants.The dsig:DigestMethod element has the following attributes.

AttributAttribute DescriptionDescription
Algorithm Algorithme utilisé pour calculer le Digest pour ce fichier.The algorithm used to calculate the digest for this file. Actuellement, la seule valeur utilisée ClickOnceClickOnce par http://www.w3.org/2000/09/xmldsig#sha1est.Currently the only value used by ClickOnceClickOnce is http://www.w3.org/2000/09/xmldsig#sha1.

dsig:DigestValuedsig:DigestValue

L' dsig:DigestValue élément est un enfant obligatoire de l' hash élément.The dsig:DigestValue element is a required child of the hash element. L’élément dsig:DigestValue ne comporte pas d’attributs.The dsig:DigestValue element has no attributes. Sa valeur texte est le hachage calculé pour le fichier spécifié.Its text value is the computed hash for the specified file.

NotesRemarks

Tous les assemblys utilisés par votre application doivent avoir un dependency élément correspondant.All assemblies used by your application must have a corresponding dependency element. Les assemblys dépendants n’incluent pas les assemblys qui doivent être préinstallés dans le Global Assembly Cache en tant qu’assemblys de plateforme.Dependent assemblies do not include assemblies that must be preinstalled in the global assembly cache as platform assemblies.

ExempleExample

L’exemple de code suivant illustre dependency les éléments d' ClickOnceClickOnce un manifeste d’application.The following code example illustrates dependency elements in a ClickOnceClickOnce application manifest. Cet exemple de code fait partie d’un exemple plus complet fourni pour la rubrique du manifeste d’application ClickOnce .This code example is part of a larger example provided for the ClickOnce Application Manifest topic.

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

Voir aussiSee also