Elemento <dependency> (applicazione ClickOnce)

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

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

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

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

os

Obbligatoria. Questo elemento è figlio dell'elemento osVersionInfo. Dispone degli attributi riportati di seguito.

Attribute

Oggetto di descrizione

majorVersion

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

minorVersion

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

buildNumber

Obbligatoria. Specifica il numero di build del sistema operativo.

servicePackMajor

Obbligatoria. 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 presenta gli attributi seguenti.

Attribute

Oggetto di descrizione

dependencyType

Obbligatoria. Consente di specificare il tipo di dipendenza. I valori validi sono preprequisite e install. Un assembly install viene installato con l'applicazione ClickOnce. L'assembly prerequisite deve essere presente nella Global Assembly Cache (GAC) prima che l'applicazione ClickOnce possa essere installata.

allowDelayedBinding

Obbligatoria. Consente di specificare se l'assembly può essere caricato a livello di codice in fase di esecuzione.

group

Facoltativo. Se l'attributo dependencyType viene impostato su install, designa un gruppo denominato di assembly che vengono installati solo su richiesta. Per ulteriori informazioni, vedere Procedura dettagliata: download di assembly su richiesta con l'API della distribuzione ClickOnce tramite la finestra di progettazione.

Se viene impostato su framework e l'attributo dependencyType viene impostato su prerequisite, designa l'assembly come parte di .NET Framework. Nella Global Assemby Cache (GAC) non viene verificata la disponibilità di questo assembly quando si esegue l'installazione in .NET Framework 4 e versioni successive.

codeBase

Obbligatorio quando l'attributo dependencyType è impostato su install. Percorso dell'assembly dipendente. 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 quando l'attributo dependencyType è impostato su install. Dimensione in byte dell'assembly dipendente.

assemblyIdentity

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

Attribute

Oggetto di descrizione

name

Obbligatoria. Identifica il nome dell'applicazione.

version

Obbligatoria. 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 dei seguenti attributi.

Attribute

Oggetto di 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 dei seguenti attributi.

Attribute

Oggetto di 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.

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

Vedere anche

Riferimenti

Manifesto dell'applicazione ClickOnce

Elemento <dependency> (distribuzione ClickOnce)