System.Deployment.Application Namespace

Com o namespace System.Deployment.Application, você pode programar o comportamento de upgrade personalizado em um aplicativo ClickOnce. With the System.Deployment.Application namespace, you can program custom upgrade behavior into your ClickOnce application.

Classes

ApplicationDeployment

Dá suporte a atualizações da implantação atual de forma programática e manipula o download sob demanda de arquivos.Supports updates of the current deployment programmatically, and handles on-demand downloading of files. Esta classe não pode ser herdada.This class cannot be inherited.

CheckForUpdateCompletedEventArgs

Representa informações de atualização detalhadas obtidas por meio de uma chamada para CheckForUpdateAsync().Represents detailed update information obtained through a call to CheckForUpdateAsync().

CompatibleFramework

Representa uma versão do .NET Framework em que um aplicativo pode ser instalado e executado.Represents a version of the .NET Framework where an application can install and run.

CompatibleFrameworkMissingException

Essa exceção é gerada quando uma versão do .NET Framework que é compatível com este aplicativo não pode ser encontrada.This exception is thrown when a version of the .NET Framework that is compatible with this application cannot be found.

CompatibleFrameworks

Fornece detalhes sobre as versões do .NET Framework nas quais este aplicativo pode ser instalado e executado.Provides details about versions of the .NET Framework on which this application can install and run.

DependentPlatformMissingException

A exceção que é gerada quando a dependência de plataforma não é encontrada durante a ativação da implantação do ClickOnce e a implantação não executa.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 que houve um erro ao baixar os manifestos ClickOnce ou os arquivos de implantação no computador cliente.Indicates that there was an error downloading either the ClickOnce manifests or the deployment's files to the client computer.

DeploymentException

Define uma classe base para todas as exceções relacionadas à implantação.Defines a base class for all deployment-related exceptions.

DeploymentProgressChangedEventArgs

Representa dados de progresso relatados em uma operação assíncrona.Represents progress data reported in an asynchronous operation.

DeploymentServiceCom

Fornece serviços internos para a API de implantação do ClickOnce.Provides internal services for the ClickOnce deployment API.

DownloadApplicationCompletedEventArgs

Fornece dados para o evento de DownloadApplicationCompleted .Provides data for the DownloadApplicationCompleted event.

DownloadFileGroupCompletedEventArgs

Descreve um download de arquivo que foi concluído recentemente.Describes a file download that has recently completed.

DownloadProgressChangedEventArgs

Fornece dados para o evento de DownloadProgressChanged .Provides data for the DownloadProgressChanged event.

GetManifestCompletedEventArgs

Fornece dados para o evento GetManifestCompleted de InPlaceHostingManager.Provides data for the GetManifestCompleted event of InPlaceHostingManager.

InPlaceHostingManager

Instalar ou atualizar uma implantação do ClickOnce em um computador.Install or update a ClickOnce deployment on a computer.

InvalidDeploymentException

Indica que o ClickOnce não pôde ler os manifestos de implantação ou de aplicativo.Indicates that ClickOnce could not read either the deployment or application manifests.

SupportedRuntimeMissingException

Esta exceção será gerada quando uma versão de runtime compatível com este aplicativo não puder ser encontrada.This exception is thrown when a runtime version that is compatible with this application cannot be found.

TrustNotGrantedException

Indica que o aplicativo não tem o nível de confiança apropriada para executá-lo no computador local.Indicates that the application does not have the appropriate level of trust to run on the local computer.

UpdateCheckInfo

Representa informações de atualização detalhadas obtidas por meio de uma chamada para CheckForDetailedUpdate().Represents detailed update information obtained through a call to CheckForDetailedUpdate().

Enumerações

DeploymentProgressState

Especifica o estágio atual de uma operação de download do ClickOnce.Specifies the current stage of a ClickOnce download operation.

Delegados

CheckForUpdateCompletedEventHandler

Representa o método que manipulará o evento CheckForUpdateCompleted de um ApplicationDeployment.Represents the method that will handle the CheckForUpdateCompleted event of an ApplicationDeployment.

DeploymentProgressChangedEventHandler

Representa o método que manipulará o evento CheckForUpdateProgressChanged, o evento UpdateProgressChanged ou o evento DownloadFileGroupProgressChanged de um ApplicationDeployment.Represents the method that will handle the CheckForUpdateProgressChanged event, UpdateProgressChanged event, or DownloadFileGroupProgressChanged event of an ApplicationDeployment.

DownloadFileGroupCompletedEventHandler

Representa o método que manipulará o evento DownloadFileGroupCompleted de um ApplicationDeployment.Represents the method that will handle the DownloadFileGroupCompleted event of an ApplicationDeployment.

Comentários

A classe de chave neste namespace é ApplicationDeployment.The key class in this namespace is ApplicationDeployment. Você pode testar se sua implantação tem uma atualização disponível usando os métodos CheckForUpdate ou CheckForUpdateAsync; o último método gera o evento CheckForUpdateCompleted quando ele é concluído com êxito.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 retorna informações importantes sobre a atualização, como seu número de versão e se é uma atualização necessária para os usuários atuais.CheckForDetailedUpdate returns important information about the update, such as its version number and whether it is a required update for current users. Se uma atualização estiver disponível, você poderá instalá-la usando Update ou UpdateAsync; o último método gera o evento UpdateCompleted após a conclusão da instalação da atualização.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. Para atualizações grandes, você pode receber notificações de progresso por meio dos eventos CheckForUpdateProgressChanged e UpdateProgressChanged e usar as informações em ProgressChangedEventArgs para notificar o usuário sobre o status de 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.

Você também pode usar ApplicationDeployment para baixar arquivos grandes e assemblies sob demanda.You can also use ApplicationDeployment to download large files and assemblies on demand. Esses arquivos devem ser marcados como "opcionais" no manifesto do aplicativo da implantação, para que eles não sejam baixados na instalação.These files must be marked as "optional" within the deployment's application manifest, so that they are not downloaded at installation. Você pode baixar os arquivos a qualquer momento durante a duração do aplicativo usando os métodos DownloadFileGroup ou DownloadFileGroupAsync.You can download the files at any point during the application's duration by using the DownloadFileGroup or DownloadFileGroupAsync methods. Você pode baixar assemblies antes que eles sejam carregados na memória, fornecendo um manipulador de eventos para o evento AssemblyResolve na classe AppDomain.You can download assemblies before they are loaded into memory by supplying an event handler for the AssemblyResolve event on the AppDomain class. Para obter mais informações, consulte Walkthrough: Downloading Assemblies on Demand with the ClickOnce Deployment API Using the Designer (Instruções passo a passo: baixando assemblies sob demanda com a API de implantação do ClickOnce usando o designer).For more information, see Walkthrough: Downloading Assemblies on Demand with the ClickOnce Deployment API Using the Designer.