System.Deployment.Application Spazio dei nomi

Con lo spazio dei nomi System.Deployment.Application è possibile programmare un comportamento di aggiornamento personalizzato nell'applicazione ClickOnce. With the System.Deployment.Application namespace, you can program custom upgrade behavior into your ClickOnce application.

Classi

ApplicationDeployment

Supporta gli aggiornamenti della distribuzione corrente a livello di codice e gestisce il download di file su richiesta.Supports updates of the current deployment programmatically, and handles on-demand downloading of files. Questa classe non può essere ereditata.This class cannot be inherited.

CheckForUpdateCompletedEventArgs

Rappresenta informazioni dettagliate sull'aggiornamento ottenute tramite una chiamata al metodo CheckForUpdateAsync().Represents detailed update information obtained through a call to CheckForUpdateAsync().

CompatibleFramework

Rappresenta una versione di .NET Framework in cui è possibile installare ed eseguire un'applicazione.Represents a version of the .NET Framework where an application can install and run.

CompatibleFrameworkMissingException

Questa eccezione viene generata quando non è possibile trovare una versione di .NET Framework compatibile con l'applicazione.This exception is thrown when a version of the .NET Framework that is compatible with this application cannot be found.

CompatibleFrameworks

Fornisce i dettagli sulle versioni di .NET Framework in cui l'applicazione può essere installata ed eseguita.Provides details about versions of the .NET Framework on which this application can install and run.

DependentPlatformMissingException

Eccezione generata quando la dipendenza di piattaforma non viene trovata durante l'attivazione della distribuzione di ClickOnce e la distribuzione non viene eseguita.The exception that is thrown when the platform dependency is not found during activation of the ClickOnce deployment and the deployment will not run.

DeploymentDownloadException

Indica che si è verificato un errore durante il download dei manifesti di ClickOnce o dei file di distribuzione al computer client.Indicates that there was an error downloading either the ClickOnce manifests or the deployment's files to the client computer.

DeploymentException

Definisce una classe di base per tutte le eccezioni relative alla distribuzione.Defines a base class for all deployment-related exceptions.

DeploymentProgressChangedEventArgs

Rappresenta i dati sullo stato forniti in un'operazione asincrona.Represents progress data reported in an asynchronous operation.

DeploymentServiceCom

Offre servizi interni per l'API di distribuzione ClickOnce.Provides internal services for the ClickOnce deployment API.

DownloadApplicationCompletedEventArgs

Fornisce dati per l'evento DownloadApplicationCompleted.Provides data for the DownloadApplicationCompleted event.

DownloadFileGroupCompletedEventArgs

Descrive un download di file completato recentemente.Describes a file download that has recently completed.

DownloadProgressChangedEventArgs

Fornisce dati per l'evento DownloadProgressChanged.Provides data for the DownloadProgressChanged event.

GetManifestCompletedEventArgs

Fornisce i dati per l'evento GetManifestCompleted della classe InPlaceHostingManager.Provides data for the GetManifestCompleted event of InPlaceHostingManager.

InPlaceHostingManager

Installa o aggiorna una distribuzione di ClickOnce in un computer.Install or update a ClickOnce deployment on a computer.

InvalidDeploymentException

Indica che ClickOnce non è in grado di leggere i manifesti di distribuzione o dell'applicazione.Indicates that ClickOnce could not read either the deployment or application manifests.

SupportedRuntimeMissingException

Questa eccezione viene generata quando non è possibile trovare una versione di runtime compatibile con l'applicazione.This exception is thrown when a runtime version that is compatible with this application cannot be found.

TrustNotGrantedException

Indica che l'applicazione non ha il livello di attendibilità corretto per l'esecuzione sul computer locale.Indicates that the application does not have the appropriate level of trust to run on the local computer.

UpdateCheckInfo

Rappresenta informazioni dettagliate sull'aggiornamento ottenute tramite una chiamata al metodo CheckForDetailedUpdate().Represents detailed update information obtained through a call to CheckForDetailedUpdate().

Enumerazioni

DeploymentProgressState

Specifica la fase corrente di un'operazione di download di ClickOnce.Specifies the current stage of a ClickOnce download operation.

Delegati

CheckForUpdateCompletedEventHandler

Rappresenta il metodo che gestirà l'evento CheckForUpdateCompleted di un oggetto ApplicationDeployment.Represents the method that will handle the CheckForUpdateCompleted event of an ApplicationDeployment.

DeploymentProgressChangedEventHandler

Rappresenta il metodo che consente di gestire l'evento CheckForUpdateProgressChanged, l'evento UpdateProgressChanged o l'evento DownloadFileGroupProgressChanged di una classe ApplicationDeployment.Represents the method that will handle the CheckForUpdateProgressChanged event, UpdateProgressChanged event, or DownloadFileGroupProgressChanged event of an ApplicationDeployment.

DownloadFileGroupCompletedEventHandler

Rappresenta il metodo che gestirà l'evento DownloadFileGroupCompleted di un oggetto ApplicationDeployment.Represents the method that will handle the DownloadFileGroupCompleted event of an ApplicationDeployment.

Commenti

La classe principale in questo spazio dei nomi è ApplicationDeployment.The key class in this namespace is ApplicationDeployment. È possibile verificare se la distribuzione, è disponibile un aggiornamento usando il CheckForUpdate o CheckForUpdateAsync metodi; il secondo metodo che genera il CheckForUpdateCompleted evento quando è stata completata.You can test whether your deployment has an available update by using either the CheckForUpdate or CheckForUpdateAsync methods; the latter method raises the CheckForUpdateCompleted event when it has successfully completed. CheckForDetailedUpdate Restituisce informazioni importanti sull'aggiornamento, ad esempio il numero di versione e se è un aggiornamento obbligatorio per gli utenti correnti.CheckForDetailedUpdate returns important information about the update, such as its version number and whether it is a required update for current users. Se è disponibile un aggiornamento, è possibile installarlo tramite Update oppure UpdateAsync; il secondo metodo genera il UpdateCompleted evento dopo aver terminato l'installazione dell'aggiornamento.If an update is available, you can install it by using Update or UpdateAsync; the latter method raises the UpdateCompleted event after installation of the update is finished. Per gli aggiornamenti di grandi dimensioni, è possibile ricevere notifiche di stato di avanzamento tramite il CheckForUpdateProgressChanged e UpdateProgressChanged eventi e usare le informazioni contenute in ProgressChangedEventArgs per notificare all'utente lo stato del download.For large updates, you can receive progress notifications through the CheckForUpdateProgressChanged and UpdateProgressChanged events, and use the information in ProgressChangedEventArgs to notify the user of the download status.

È anche possibile usare ApplicationDeployment per scaricare i file di grandi dimensioni e gli assembly su richiesta.You can also use ApplicationDeployment to download large files and assemblies on demand. Questi file devono essere contrassegnati come "facoltativi" nel manifesto dell'applicazione di distribuzione, in modo che vengano scaricati in fase di installazione.These files must be marked as "optional" within the deployment's application manifest, so that they are not downloaded at installation. È possibile scaricare i file in qualsiasi momento durante la durata dell'applicazione tramite il DownloadFileGroup o DownloadFileGroupAsync metodi.You can download the files at any point during the application's duration by using the DownloadFileGroup or DownloadFileGroupAsync methods. È possibile scaricare gli assembly prima che vengano caricati in memoria, fornendo un gestore eventi per il AssemblyResolve evento sul AppDomain classe.You can download assemblies before they are loaded into memory by supplying an event handler for the AssemblyResolve event on the AppDomain class. Per altre informazioni, vedere Procedura dettagliata: Download di assembly su richiesta con l'API della distribuzione ClickOnce tramite la finestra di progettazione.For more information, see Walkthrough: Downloading Assemblies on Demand with the ClickOnce Deployment API Using the Designer.