<elemento dependency> (applicazione ClickOnce)

Articolo
01/12/2024

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

Sintassi


      <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 essere presenti più istanze di nello stesso manifesto dell'applicazione dependency .

L'elemento dependency non ha attributi e contiene gli elementi figlio seguenti.

dependentOS

Facoltativo. Contiene l'elemento osVersionInfo . Gli dependentOS elementi e dependentAssembly si escludono a vicenda: uno o l'altro deve esistere per un dependency elemento, ma non entrambi.

dependentOS supporta gli attributi seguenti.

Attributo	Descrizione
`supportUrl`	Facoltativo. Specifica un URL di supporto per la piattaforma dipendente. Questo URL viene visualizzato all'utente se viene trovata la piattaforma necessaria.
`description`	Facoltativo. Descrive, in forma leggibile, il sistema operativo descritto dall'elemento `dependentOS` .

osVersionInfo

Obbligatorio. Questo elemento è figlio dell'elemento dependentOS e contiene l'elemento os . Questo elemento non ha attributi.

OS

Obbligatorio. Questo elemento è figlio dell'elemento osVersionInfo . Questo elemento ha gli attributi seguenti.

Attributo	Descrizione
`majorVersion`	Obbligatorio. Specifica il numero di versione principale del sistema operativo.
`minorVersion`	Obbligatorio. Specifica il numero di versione secondaria 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 10, questo valore dell'attributo è `workstation`.
`suiteType`	Facoltativo. Identifica una suite di prodotti 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, questo valore dell'attributo è `professional`.

dependentAssembly

Facoltativo. Contiene l'elemento assemblyIdentity . Gli dependentOS elementi e dependentAssembly si escludono a vicenda: uno o l'altro deve esistere per un dependency elemento, ma non entrambi.

dependentAssembly ha gli attributi seguenti.

Attributo	Descrizione
`dependencyType`	Obbligatorio. Specifica il tipo di dipendenza. I valori validi sono `prerequisite` e `install`. Un `install` assembly viene installato come parte dell'applicazione ClickOnce. Un `prerequisite` assembly deve essere presente nella Global Assembly Cache (GAC) prima che l'applicazione ClickOnce possa essere installata.
`allowDelayedBinding`	Obbligatorio. Specifica se l'assembly può essere caricato a livello di codice in fase di esecuzione.
`group`	Facoltativo. Se l'attributo `dependencyType` è impostato su `install`, designa un gruppo denominato di assembly che installa solo su richiesta. Per altre informazioni, vedere Procedura dettagliata: Download di assembly su richiesta con l'API della distribuzione ClickOnce tramite la finestra di progettazione. Se impostato su e l'attributo `dependencyType` è impostato `framework` su `prerequisite`, designa l'assembly come parte di .NET Framework. La Global Assembly Cache (GAC) non è selezionata per questo assembly durante 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 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 dell'assembly dipendente, in byte.

assemblyIdentity

Obbligatorio. Questo elemento è figlio dell'elemento dependentAssembly e ha l'attributo seguente.

Attributo	Descrizione
`name`	Obbligatorio. Identifica il nome dell'applicazione.
`version`	Obbligatorio. Specifica il numero di versione dell'applicazione nel formato seguente: `major.minor.build.revision`
`publicKeyToken`	Facoltativo. Specifica una stringa esadecimale di 16 caratteri che rappresenta gli ultimi 8 byte del `SHA-1` valore hash della chiave pubblica in cui è firmata l'applicazione o l'assembly. La chiave pubblica usata per firmare il catalogo deve essere di almeno 2048 bit.
`processorArchitecture`	Facoltativo. Specifica il processore. I valori validi sono `x86` per Windows a 32 bit e `I64` per Windows a 64 bit.
`language`	Facoltativo. Identifica i codici linguistici in due parti, ad esempio EN-US, dell'assembly.

hash

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

ClickOnce usa un hash algoritmico di tutti i file in un'applicazione come controllo di sicurezza, per assicurarsi che nessuno dei file sia stato modificato dopo la distribuzione. Se l'elemento hash non è incluso, questo controllo non verrà eseguito. Pertanto, l'omissione dell'elemento hash non è consigliata.

dsig:Transforms

L'elemento dsig:Transforms è un elemento figlio obbligatorio dell'elemento hash . L'elemento dsig:Transforms non ha attributi.

dsig:Transform

L'elemento dsig:Transform è un elemento figlio obbligatorio dell'elemento dsig:Transforms . L'elemento dsig:Transform presenta gli attributi seguenti.

Attributo	Descrizione
`Algorithm`	Algoritmo utilizzato per calcolare il digest per questo file. Attualmente l'unico valore usato da ClickOnce è `urn:schemas-microsoft-com:HashTransforms.Identity`.

dsig:DigestMethod

L'elemento dsig:DigestMethod è un elemento figlio obbligatorio dell'elemento hash . L'elemento dsig:DigestMethod presenta gli attributi seguenti.

Attributo	Descrizione
`Algorithm`	Algoritmo utilizzato per calcolare il digest per questo file. Attualmente l'unico valore usato da ClickOnce è `http://www.w3.org/2000/09/xmldsig#sha1`.

dsig:DigestValue

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

Osservazioni:

Tutti gli assembly usati dall'applicazione devono avere un elemento corrispondente dependency . Gli assembly dipendenti non includono assembly che devono essere preinstallati nella Global Assembly Cache come assembly della piattaforma.

Esempio

L'esempio di codice seguente illustra gli dependency elementi in un manifesto dell'applicazione ClickOnce. Questo esempio di codice fa parte di un esempio più ampio 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>

Condividi tramite