<elemento deployment> (distribuzione ClickOnce)

Articolo
01/12/2024

Identifica gli attributi usati per la distribuzione degli aggiornamenti e l'esposizione al sistema.

Sintassi


      <deployment
   install
   minimumRequiredVersion
   mapFileExtensions
   disallowUrlActivation
   trustUrlParameters
>
   <subscription>
         <update>
            <beforeApplicationStartup/>
            <expiration
               maximumAge
               unit
            />
         </update>
   </subscription>
   <deploymentProvider
      codebase
   />
</deployment>

Elementi e attributi

L'elemento deployment è obbligatorio e si trova nello spazio dei nomi urn:schemas-microsoft-com:asm.v2 . L'elemento presenta gli attributi seguenti.

Attributo	Descrizione
`install`	Obbligatorio. Specifica se questa applicazione definisce una presenza nel menu Start di Windows e nell'applicazione Installazione applicazioni Pannello di controllo. I valori validi sono `true` e `false`. Se `false`, ClickOnce eseguirà sempre la versione più recente dell'applicazione dalla rete e non riconoscerà l'elemento `subscription` .
`minimumRequiredVersion`	Facoltativo. Specifica la versione minima di questa applicazione che può essere eseguita nel client. Se il numero di versione dell'applicazione è minore del numero di versione fornito nel manifesto della distribuzione, l'applicazione non verrà eseguita. I numeri di versione devono essere specificati nel formato `N.N.N.N`, dove `N` è un intero senza segno. Se l'attributo `install` è `false`, `minimumRequiredVersion` non deve essere impostato.
`mapFileExtensions`	Facoltativo. Il valore predefinito è `false`. Se `true`, tutti i file nella distribuzione devono avere un'estensione deploy. ClickOnce rimuoverà questa estensione da questi file non appena li scarica dal server Web. Se si pubblica l'applicazione usando Visual Studio, questa estensione viene aggiunta automaticamente a tutti i file. Questo parametro consente il download di tutti i file all'interno di una distribuzione ClickOnce da un server Web che blocca la trasmissione dei file che terminano con estensioni "non sicure", ad esempio .exe.
`disallowUrlActivation`	Facoltativo. Il valore predefinito è `false`. Se `true`, impedisce l'avvio di un'applicazione installata facendo clic sull'URL o immettendo l'URL in un browser. Se l'attributo `install` non è presente, questo attributo viene ignorato.
`trustURLParameters`	Facoltativo. Il valore predefinito è `false`. Se `true`, consente all'URL di contenere parametri di stringa di query passati all'applicazione, analogamente agli argomenti della riga di comando vengono passati a un'applicazione della riga di comando. Per altre informazioni, vedere Procedura: Recuperare informazioni sulla stringa di query in un'applicazione ClickOnce online. Se l'attributo `disallowUrlActivation` è `true`, `trustUrlParameters` deve essere escluso dal manifesto o impostato in modo esplicito su `false`.

L'elemento deployment contiene anche gli elementi figlio seguenti.

sottoscrizione

Facoltativo. Contiene l'elemento update . L'elemento subscription non ha attributi. Se l'elemento subscription non esiste, l'applicazione ClickOnce non analizzerà mai gli aggiornamenti. Se l'attributo dell'elemento install è false, l'elemento deployment subscription viene ignorato, perché un'applicazione ClickOnce avviata dalla rete usa sempre la versione più recente.

update

Obbligatorio. Questo elemento è un elemento figlio dell'elemento subscription e contiene o beforeApplicationStartup l'elemento expiration . beforeApplicationStartup e expiration non possono essere specificati entrambi nello stesso manifesto di distribuzione.

L'elemento update non ha attributi.

beforeApplicationStartup

Facoltativo. Questo elemento è un elemento figlio dell'elemento update e non ha attributi. Quando l'elemento beforeApplicationStartup esiste, l'applicazione verrà bloccata quando ClickOnce verifica la presenza di aggiornamenti, se il client è online. Se questo elemento non esiste, ClickOnce analizzerà prima di tutto gli aggiornamenti in base ai valori specificati per l'elemento expiration . beforeApplicationStartup e expiration non possono essere specificati entrambi nello stesso manifesto di distribuzione.

expiration

Facoltativo. Questo elemento è un elemento figlio dell'elemento update e non ha elementi figlio. beforeApplicationStartup e expiration non possono essere specificati entrambi nello stesso manifesto di distribuzione. Quando si verifica il controllo degli aggiornamenti e viene rilevata una versione aggiornata, la nuova versione viene memorizzata nella cache durante l'esecuzione della versione esistente. La nuova versione viene quindi installata al successivo avvio dell'applicazione ClickOnce.

L'elemento expiration supporta gli attributi seguenti.

Attributo	Descrizione
`maximumAge`	Obbligatorio. Identifica la data in cui deve diventare l'aggiornamento corrente prima che l'applicazione esegua un controllo degli aggiornamenti. L'unità di tempo è determinata dall'attributo `unit` .
`unit`	Obbligatorio. Identifica l'unità di tempo per `maximumAge`. Le unità valide sono `hours`, `days`e `weeks`.

deploymentProvider

Per .NET Framework 2.0, questo elemento è obbligatorio se il manifesto della distribuzione contiene una subscription sezione. Per .NET Framework 3.5 e versioni successive, questo elemento è facoltativo e per impostazione predefinita verrà usato il server e il percorso del file in cui è stato individuato il manifesto della distribuzione.

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

Attributo	Descrizione
`codebase`	Obbligatorio. Identifica il percorso, come URI (Uniform Resource Identifier) del manifesto della distribuzione usato per aggiornare l'applicazione ClickOnce. Questo elemento consente anche l'inoltro dei percorsi di aggiornamento per le installazioni basate su CD. Deve essere un URI valido.

Osservazioni:

È possibile configurare l'applicazione ClickOnce per analizzare gli aggiornamenti all'avvio, analizzare gli aggiornamenti dopo l'avvio o non verificare mai la disponibilità di aggiornamenti. Per cercare gli aggiornamenti all'avvio, verificare che l'elemento beforeApplicationStartup esista sotto l'elemento update . Per analizzare gli aggiornamenti dopo l'avvio, verificare che l'elemento expiration esista sotto l'elemento update e che vengano forniti gli intervalli di aggiornamento.

Per disabilitare il controllo degli aggiornamenti, rimuovere l'elemento subscription . Quando si specifica nel manifesto della distribuzione per non cercare mai gli aggiornamenti, è comunque possibile verificare manualmente la disponibilità di aggiornamenti usando il CheckForUpdate metodo .

Nota

La ApplicationDeployment classe e le API nello System.Deployment.Application spazio dei nomi non sono supportate in .NET Core e .NET 5 e versioni successive. In .NET 7 è supportato un nuovo metodo di accesso alle proprietà di distribuzione dell'applicazione. Per altre informazioni, vedere Accedere alle proprietà di distribuzione ClickOnce in .NET. .NET 7 non supporta l'equivalente dei metodi ApplicationDeployment.

Per altre informazioni sulla correlazione tra deploymentProvider e gli aggiornamenti, vedere Scelta di una strategia di aggiornamento ClickOnce.

Esempi

Nell'esempio di codice seguente viene illustrato un deployment elemento in un manifesto della distribuzione ClickOnce. Nell'esempio viene utilizzato un deploymentProvider elemento per indicare il percorso di aggiornamento preferito.

<deployment install="true" minimumRequiredVersion="2.0.0.0" mapFileExtension="true" trustUrlParameters="true">
    <subscription>
      <update>
        <expiration maximumAge="6" unit="hours" />
      </update>
    </subscription>
    <deploymentProvider codebase="http://www.adatum.com/MyApplication.application" />
  </deployment>

Vedi anche

Manifesto di distribuzione ClickOnce

Condividi tramite