System.Deployment.Application Пространство имен

С помощью пространства имен System.Deployment.Application можно запрограммировать пользовательскую процедуру обновления приложения ClickOnce. With the System.Deployment.Application namespace, you can program custom upgrade behavior into your ClickOnce application.

Классы

ApplicationDeployment

Поддерживает программное обновление текущего развертывания и обрабатывает загрузку файлов по требованию.Supports updates of the current deployment programmatically, and handles on-demand downloading of files. Этот класс не наследуется.This class cannot be inherited.

CheckForUpdateCompletedEventArgs

Предоставляет детализированные сведения об обновлении, полученные с помощью обращения к методу CheckForUpdateAsync().Represents detailed update information obtained through a call to CheckForUpdateAsync().

CompatibleFramework

Представляет версию платформы .NET Framework, в которой можно устанавливать и запускать приложения.Represents a version of the .NET Framework where an application can install and run.

CompatibleFrameworkMissingException

Это исключение создается, если не удается найти версию .NET Framework, совместимую с данным приложением.This exception is thrown when a version of the .NET Framework that is compatible with this application cannot be found.

CompatibleFrameworks

Предоставляет сведения о версии платформы .NET Framework, в которой можно устанавливать и запускать данное приложение.Provides details about versions of the .NET Framework on which this application can install and run.

DependentPlatformMissingException

Исключение, которое создается, если во время активации развернутого экземпляра ClickOnce не была найдена зависимость платформы и экземпляр не запущен.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

Указывает на наличие ошибки при скачивании манифестов ClickOnce или файлов развертывания на клиентский компьютер.Indicates that there was an error downloading either the ClickOnce manifests or the deployment's files to the client computer.

DeploymentException

Определяет базовый класс для всех связанных с развертыванием исключений.Defines a base class for all deployment-related exceptions.

DeploymentProgressChangedEventArgs

Представляет состояние хода выполнения асинхронной операции.Represents progress data reported in an asynchronous operation.

DeploymentServiceCom

Предоставляет внутренние службы для API развертывания ClickOnce.Provides internal services for the ClickOnce deployment API.

DownloadApplicationCompletedEventArgs

Предоставляет данные для события DownloadApplicationCompleted.Provides data for the DownloadApplicationCompleted event.

DownloadFileGroupCompletedEventArgs

Описывает последнюю завершенную загрузку файла.Describes a file download that has recently completed.

DownloadProgressChangedEventArgs

Предоставляет данные для события DownloadProgressChanged.Provides data for the DownloadProgressChanged event.

GetManifestCompletedEventArgs

Предоставляет данные для события GetManifestCompletedInPlaceHostingManager.Provides data for the GetManifestCompleted event of InPlaceHostingManager.

InPlaceHostingManager

Устанавливает или обновляет развернутый на компьютере экземпляр ClickOnce.Install or update a ClickOnce deployment on a computer.

InvalidDeploymentException

Указывает на то, что ClickOnce не удалось прочитать манифест развертывания или манифест приложения.Indicates that ClickOnce could not read either the deployment or application manifests.

SupportedRuntimeMissingException

Это исключение создается, если не удается найти версию среды выполнения, совместимую с данным приложением.This exception is thrown when a runtime version that is compatible with this application cannot be found.

TrustNotGrantedException

Указывает, что приложение не имеет соответствующего уровня доверия для запуска на локальном компьютере.Indicates that the application does not have the appropriate level of trust to run on the local computer.

UpdateCheckInfo

Предоставляет детализированные сведения об обновлении, полученные с помощью обращения к методу CheckForDetailedUpdate().Represents detailed update information obtained through a call to CheckForDetailedUpdate().

Перечисления

DeploymentProgressState

Указывает текущий этап операции скачивания ClickOnce.Specifies the current stage of a ClickOnce download operation.

Делегаты

CheckForUpdateCompletedEventHandler

Представляет метод, обрабатывающий событие CheckForUpdateCompletedApplicationDeployment.Represents the method that will handle the CheckForUpdateCompleted event of an ApplicationDeployment.

DeploymentProgressChangedEventHandler

Предоставляет метод, обрабатывающий события CheckForUpdateProgressChanged, UpdateProgressChanged или событие DownloadFileGroupProgressChangedApplicationDeployment.Represents the method that will handle the CheckForUpdateProgressChanged event, UpdateProgressChanged event, or DownloadFileGroupProgressChanged event of an ApplicationDeployment.

DownloadFileGroupCompletedEventHandler

Представляет метод, обрабатывающий событие DownloadFileGroupCompletedApplicationDeployment.Represents the method that will handle the DownloadFileGroupCompleted event of an ApplicationDeployment.

Комментарии

Является ключевой класс в этом пространстве имен ApplicationDeployment.The key class in this namespace is ApplicationDeployment. Вы можете протестировать развертывание включено доступное обновление, либо при помощи CheckForUpdate или CheckForUpdateAsync методов; последний метод вызывает CheckForUpdateCompleted событий после успешного завершения.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 Возвращает важные сведения об обновлении, например номера версии и является ли он необходимым обновлением для текущих пользователей.CheckForDetailedUpdate returns important information about the update, such as its version number and whether it is a required update for current users. Если доступно обновление, его можно установить с помощью Update или UpdateAsync; последний метод вызывает UpdateCompleted событий после завершения установки обновления.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. Для больших обновлений может получать уведомления о ходе выполнения через CheckForUpdateProgressChanged и UpdateProgressChanged события и используйте сведения в ProgressChangedEventArgs для уведомления пользователя о состоянии загрузки.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.

Можно также использовать ApplicationDeployment для загрузки больших файлов и сборок по требованию.You can also use ApplicationDeployment to download large files and assemblies on demand. Эти файлы должны быть помечены во время установки манифест приложения развертывания, как «необязательные».These files must be marked as "optional" within the deployment's application manifest, so that they are not downloaded at installation. Можно загрузить файлы в любой момент во время длительности приложения с помощью DownloadFileGroup или DownloadFileGroupAsync методы.You can download the files at any point during the application's duration by using the DownloadFileGroup or DownloadFileGroupAsync methods. Вы можете скачать сборок, прежде чем они были загружены в память, указав обработчик событий для AssemblyResolve событий на AppDomain класса.You can download assemblies before they are loaded into memory by supplying an event handler for the AssemblyResolve event on the AppDomain class. Подробнее см. в разделе Пошаговое руководство. Загрузка сборок по требованию с помощью API развертывания ClickOnce с использованием конструктора.For more information, see Walkthrough: Downloading Assemblies on Demand with the ClickOnce Deployment API Using the Designer.