Condividi tramite

Elemento <dependency> (applicazione ClickOnce)

Aggiornamento: Luglio 2008

Identifica una piattaforma o una dipendenza assembly necessaria per l'applicazione.

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

Elementi e attributi

L'elemento dependency è obbligatorio. Possono coesistere più istanze dell'elemento dependency nello stesso manifesto dell'applicazione.

L'elemento dependency non dispone di attributi e contiene gli elementi figlio riportati di seguito.

dependentOS

Facoltativo. Contiene l'elemento osVersionInfo. Gli elementi dependentOS e dependentAssembly si escludono a vicenda. Per un elemento dependency è necessaria la presenza di uno solo di essi.

dependentOS supporta gli attributi riportati di seguito.

Attribute

>Descrizione

supportUrl

Facoltativo. Specifica un URL di supporto per la piattaforma dipendente. Questo URL viene visualizzato se viene trovata la piattaforma richiesta.

description

Facoltativo. Descrive in forma leggibile il sistema operativo specificato dall'elemento dependentOS.

osVersionInfo

Obbligatorio. Questo elemento è un elemento figlio di dependentOS e contiene l'elemento os. Non dispone di attributi.

os

Obbligatorio. Questo elemento è un elemento figlio di osVersionInfo. Dispone degli attributi riportati di seguito.

Attribute

Descrizione

majorVersion

Obbligatorio. Specifica il numero di versione principale del sistema operativo.

minorVersion

Obbligatorio. Specifica il numero di versione secondario del sistema operativo.

buildNumber

Obbligatorio. Specifica il numero di build del sistema operativo.

servicePackMajor

Obbligatorio. Specifica il numero principale del Service Pack del sistema operativo.

servicePackMinor

Facoltativo. Specifica il numero secondario del Service Pack del sistema operativo.

productType

Facoltativo. Identifica il valore del tipo di prodotto. I valori validi sono server, workstation e domainController. Ad esempio, per Windows 2000 Professional il valore di questo attributo è workstation.

suiteType

Facoltativo. Identifica una suite del prodotto disponibile nel sistema o il tipo di configurazione del sistema. I valori validi sono backoffice, blade, datacenter, enterprise, home, professional, smallbusiness, smallbusinessRestricted e terminal. Ad esempio, per Windows 2000 Professional il valore di questo attributo è professional.

dependentAssembly

Facoltativo. Contiene l'elemento assemblyIdentity. Gli elementi dependentOS e dependentAssembly si escludono a vicenda. Per un elemento dependency è necessaria la presenza di uno solo di essi.

dependentAssembly dispone degli attributi riportati di seguito.

Attribute

Descrizione

 
codeBase

Obbligatorio. Percorso dell'assembly rappresentato da questo assembly. Può essere un percorso assoluto o un percorso relativo rispetto alla codebase del manifesto. Questo percorso deve essere un URI valido affinché il manifesto dell'assembly sia valido.

size

Obbligatorio. Dimensione in byte dell'assembly dipendente.

assemblyIdentity

Obbligatorio. Questo elemento è un elemento figlio di dependentAssembly e dispone degli attributi riportati di seguito.

Attribute

Descrizione

name

Obbligatorio. Identifica il nome dell'applicazione.

version

Obbligatorio. Specifica il numero di versione dell'applicazione nel seguente formato: principale.secondario.build.revisione.

publicKeyToken

Facoltativo. Specifica una stringa esadecimale di 16 caratteri che rappresenta gli ultimi 8 byte del valore hash SHA-1 della chiave pubblica utilizzata per firmare l'applicazione o l'assembly. La lunghezza minima della chiave pubblica utilizzata per firmare il catalogo deve essere di 2048 bit.

processorArchitecture

Facoltativo. Specifica il tipo di processore. I valori validi sono x86 per Windows a 32 bit e I64 per Windows a 64 bit.

language

Facoltativo. Identifica i codici di lingua in due parti dell'assembly, ad esempio IT-IT.

hash

hash è un elemento figlio facoltativo dell'elemento assemblyIdentity. L'elemento hash non contiene attributi.

ClickOnce utilizza un hash algoritmico di tutti i file contenuti in un'applicazione come controllo di sicurezza per garantire che nessun file venga modificato dopo la distribuzione. Se l'elemento hash non viene incluso, questo controllo non verrà eseguito. Pertanto, non è consigliabile omettere l'elemento hash.

dsig:Transforms

L'elemento dsig:Transforms è un elemento figlio obbligatorio di hash. L'elemento dsig:Transforms non contiene attributi.

dsig:Transform

L'elemento dsig:Transform è un elemento figlio obbligatorio di dsig:Transforms. L'elemento dsig:Transform dispone degli attributi riportati di seguito.

Attribute

Descrizione

Algorithm

Algoritmo usato per calcolare la classificazione di questo file. L'unico valore attualmente utilizzato da ClickOnce è urn:schemas-microsoft-com:HashTransforms.Identity.

dsig:DigestMethod

L'elemento dsig:DigestMethod è un elemento figlio obbligatorio di hash. L'elemento dsig:DigestMethod dispone degli attributi riportati di seguito.

Attribute

Descrizione

Algorithm

Algoritmo usato per calcolare la classificazione di questo file. L'unico valore attualmente utilizzato da ClickOnce è http://www.w3.org/2000/09/xmldsig#sha1.

dsig:DigestValue

L'elemento dsig:DigestValue è un elemento figlio obbligatorio di hash. L'elemento dsig:DigestValue non contiene attributi. Il relativo valore di testo rappresenta l'hash calcolato per il file specificato.

Note

Tutti gli assembly utilizzati dall'applicazione devono disporre di un elemento dependency corrispondente. Gli assembly dipendenti non includono gli assembly che è necessario preinstallare nella Global Assembly Cache come assembly di piattaforma.

Esempio

Nell'esempio di codice seguente vengono illustrati gli elementi dependency presenti in un manifesto dell'applicazione ClickOnce. L'esempio di codice fa parte di un esempio più esaustivo fornito per l'argomento Manifesto dell'applicazione ClickOnce.

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

Vedere anche

Riferimenti

Manifesto dell'applicazione ClickOnce

Cronologia delle modifiche

Data

Cronologia

Motivo

Luglio 2008

Aggiunte informazioni facoltative sull'elemento hash.

Miglioramento delle informazioni.
  • Last updated on