Управление обновлениями для ClickOnce-приложения

Приложения ClickOnce могут проверка для обновлений автоматически или программно. У разработчика есть много гибкости в определении того, когда и как выполняются обновления проверка, являются ли обновления обязательными, и где приложение должно проверка для обновлений.

Вы можете настроить приложение на проверка для обновлений автоматически до запуска приложения или с заданными интервалами после запуска приложения. Кроме того, можно указать минимальную требуемую версию; То есть обновление устанавливается, если версия пользователя ниже требуемой версии.

Приложение можно настроить для проверка обновлений программным способом на основе события, например запроса пользователя. Процедура "Проверка для обновлений программным способом" в этом разделе показывает, как писать код, использующий ApplicationDeployment класс для проверка обновлений на основе события.

Примечание.

Класс ApplicationDeployment и API в System.Deployment.Application пространстве имен не поддерживаются в .NET Core и .NET 5 и более поздних версиях. В .NET 7 поддерживается новый метод доступа к свойствам развертывания приложения. Дополнительные сведения см. в разделе "Свойства развертывания Access ClickOnce" в .NET. .NET 7 не поддерживает эквивалент методов ApplicationDeployment.

Вы также можете развернуть приложение из одного расположения и обновить его из другого. См. процедуру "Указание другого расположения обновления".

Дополнительные сведения см. в разделе "Выбор стратегии обновления ClickOnce".

Поведение обновления управляется в диалоговом окне "Приложение Обновления", доступном на странице публикации конструктора проектов.

Проверка обновлений до запуска приложения

  1. Выберите проект в обозревателе решений, а затем в меню Проект щелкните Свойства.

  2. Перейдите на вкладку Публикация.

    Примечание.

    В ClickOnce для .NET Core 3.1 и .NET 5 или более поздней версии вы устанавливаете свойства развертывания с помощью средства публикации вместо мастера публикации и страницы публикации конструктора проектов. Дополнительные сведения см. в статье "Развертывание приложения .NET Для Windows с помощью ClickOnce и ClickOnce для .NET".

  3. Нажмите кнопку Обновления, чтобы открыть диалоговое окно "Приложение Обновления".

  4. В диалоговом окне "Приложение Обновления" убедитесь, что приложение должно проверка для обновлений проверка поле.

  5. В разделе "Выбор того, когда приложение должно проверка для обновлений", выберите "Перед запуском приложения". Это гарантирует, что пользователи, подключенные к сети, всегда запускают приложение с последними обновлениями.

Проверка наличия обновлений в фоновом режиме, после запуска приложения

  1. Выберите проект в обозревателе решений, а затем в меню Проект щелкните Свойства.

  2. Перейдите на вкладку Публикация.

  3. Нажмите кнопку Обновления, чтобы открыть диалоговое окно "Приложение Обновления".

  4. В диалоговом окне "Приложение Обновления" убедитесь, что выбрано поле проверка Приложение должно проверка для обновлений.

  5. В разделе "Выбор того, когда приложение должно проверка для обновлений", выберите "После запуска приложения". Приложение будет запускаться быстрее, а затем проверка для обновлений в фоновом режиме и уведомлять пользователя только о доступности обновления. После установки обновления не вступают в силу до перезапуска приложения.

  6. В разделе "Указание частоты проверка приложения для обновлений" выберите "Проверить каждый раз при запуске приложения" (по умолчанию) или "Проверить каждый" и ввести число и интервал времени.

Примечание.

В ClickOnce для .NET Core и .NET 5 или более поздней версии эта задача не поддерживается. Дополнительные сведения см. в разделе ClickOnce для .NET.

Указание минимальной требуемой версии для приложения

  1. Выберите проект в обозревателе решений, а затем в меню Проект щелкните Свойства.

  2. Перейдите на вкладку Публикация.

  3. Нажмите кнопку Обновления, чтобы открыть диалоговое окно "Приложение Обновления".

  4. В диалоговом окне "Приложение Обновления" убедитесь, что приложение должно проверка для обновлений проверка поле.

  5. Выберите минимальную требуемую версию для этого приложения проверка поле, а затем введите номера основных, дополнительных, дополнительных, сборок и редакций для приложения.

Указание другого расположения обновления

  1. Выберите проект в обозревателе решений, а затем в меню Проект щелкните Свойства.

  2. Перейдите на вкладку Публикация.

  3. Нажмите кнопку Обновления, чтобы открыть диалоговое окно "Приложение Обновления".

  4. В диалоговом окне "Приложение Обновления" убедитесь, что приложение должно проверка для обновлений проверка поле.

  5. В поле "Расположение обновления" введите расположение обновления с полным URL-адресом, используя формат http://Hostname/ApplicationNameили UNC-путь с помощью формата \\Server\ApplicationName, или нажмите кнопку "Обзор", чтобы найти расположение обновления.

Программное проверка обновлений

  1. Выберите проект в обозревателе решений, а затем в меню Проект щелкните Свойства.

  2. Перейдите на вкладку Публикация.

  3. Нажмите кнопку Обновления, чтобы открыть диалоговое окно "Приложение Обновления".

  4. В диалоговом окне "Приложение Обновления", убедитесь, что приложение должно проверка для обновлений проверка поля. (При необходимости можно выбрать это поле проверка, чтобы проверка для обновлений программными средствами, а также позволить среде выполнения ClickOnce проверка для обновлений автоматически.)

  5. В поле "Расположение обновления" введите расположение обновления с полным URL-адресом, используя формат http://Hostname/ApplicationNameили UNC-путь с помощью формата \\Server\ApplicationName, или нажмите кнопку "Обзор", чтобы найти расположение обновления. Расположение обновления — это место, в котором приложение будет искать обновленную версию.

  6. Создайте кнопку, пункт меню или другой элемент пользовательского интерфейса в Windows Form, который пользователи будут выбирать для проверка обновлений. Из обработчика событий этого элемента вызовите метод для проверка обновлений и установки обновлений. Пример кода Visual Basic и Visual C# для такого метода см. в разделе "Практическое руководство. Проверка обновлений приложений программным способом с помощью API развертывания ClickOnce".

  7. Создайте приложение.