方法: ClickOnce アプリケーションの更新プログラムを管理するHow to: Manage updates for a ClickOnce application

ClickOnceClickOnceアプリケーションでは、更新プログラムを自動的にチェックするか、プログラムによって確認できます。applications can check for updates automatically or programmatically. 開発者は、更新プログラムのチェックを実行するタイミングと方法、更新プログラムが必須かどうか、アプリケーションが更新プログラムをチェックする場所などを柔軟に指定できます。As a developer, you have lots of flexibility in specifying when and how update checks are performed, whether updates are mandatory, and where the application should check for updates.

アプリケーションを開始する前に自動的に更新プログラムをチェックするようにアプリケーションを構成することも、アプリケーションの起動後に設定することもできます。You can configure the application to check for updates automatically before the application starts, or at set intervals after the application starts. また、最低限必要なバージョンを指定することもできます。つまり、ユーザーのバージョンが必要なバージョンより古い場合は、更新プログラムがインストールされます。In addition you can specify a minimum required version; that is, an update is installed if the user's version is lower than the required version.

ユーザー要求などのイベントに基づいて、プログラムで更新プログラムをチェックするようにアプリケーションを構成できます。You can configure the application to check for updates programmatically based on an event such as a user request. このトピックの「プログラムによって更新プログラムを確認するには」の手順では、 ApplicationDeploymentクラスを使用して、イベントに基づいて更新プログラムをチェックするコードを記述する方法を示します。The procedure "To check for updates programmatically" in this topic shows how you would write code that uses the ApplicationDeployment class to check for updates based on an event.

また、アプリケーションを1つの場所から配置し、別の場所から更新することもできます。You can also deploy your application from one location and update it from another. 「別の更新の場所を指定するには」の手順を参照してください。See the procedure "To specify a different update location."

詳細については、「ClickOnce の更新方法の選択」を参照してください。For more information, see Choosing a ClickOnce Update Strategy.

更新動作は、プロジェクトデザイナーの [発行] ページから使用できる [アプリケーションの更新プログラム] ダイアログボックスで管理されます。Update behavior is managed in the Application Updates dialog box, available from the Publish page of the Project Designer.

アプリケーションを起動する前に更新プログラムを確認するにはTo check for updates before the application starts

  1. ソリューション エクスプローラーでプロジェクトを選択し、 [プロジェクト] メニューの [プロパティ] をクリックします。With a project selected in Solution Explorer, on the Project menu, click Properties.

  2. [発行] タブをクリックします。Click the Publish tab.

  3. [更新] ボタンをクリックして、 [アプリケーションの更新] ダイアログボックスを開きます。Click the Updates button to open the Application Updates dialog box.

  4. [アプリケーションの更新プログラム] ダイアログボックスで、 [アプリケーションの更新プログラムを確認する] チェックボックスがオンになっていることを確認します。In the Application Updates dialog box, make sure that the The application should check for updates check box is selected.

  5. [アプリケーションが更新プログラムを確認するタイミングを選択] してください セクションで、 [アプリケーションの開始前に] を選択します。In the Choose when the application should check for updates section, select Before the application starts. これにより、ネットワークに接続されているユーザーは常に最新の更新プログラムを使用してアプリケーションを実行します。This ensures that users connected to the network always run the application with the latest updates.

アプリケーションの起動後に、バック グラウンドで更新プログラムを確認するにはTo check for updates in the background after the application starts

  1. ソリューション エクスプローラーでプロジェクトを選択し、 [プロジェクト] メニューの [プロパティ] をクリックします。With a project selected in Solution Explorer, on the Project menu, click Properties.

  2. [発行] タブをクリックします。Click the Publish tab.

  3. [更新] ボタンをクリックして、 [アプリケーションの更新] ダイアログボックスを開きます。Click the Updates button to open the Application Updates dialog box.

  4. [アプリケーションの更新プログラム] ダイアログボックスで、 [アプリケーションの更新プログラムを確認する] チェックボックスがオンになっていることを確認します。In the Application Updates dialog box, make sure that the check box The application should check for updates is selected.

  5. [アプリケーションが更新プログラムを確認するタイミングを選択] してください セクションで、 [アプリケーションの開始後] を選択します。In the Choose when the application should check for updates section, select After the application starts. このようにすると、アプリケーションの起動が速くなり、バックグラウンドで更新プログラムがチェックされ、更新プログラムが利用可能になったときにのみユーザーに通知されます。The application will start more quickly this way, and then it will check for updates in the background, and only notify the user when an update is available. インストールが完了すると、アプリケーションが再起動されるまで更新は有効になりません。Once installed, updates will not take effect until the application is restarted.

  6. [アプリケーションが更新プログラムを確認する頻度を指定してください] セクションで、[アプリケーションが実行されるたびにチェックする (既定)] または [すべてを確認] を選択し、数値と時間間隔を入力します。In the Specify how frequently the application should check for updates section, select either Check every time the application runs (the default) or Check every and enter a number and time interval.

アプリケーションに最低限必要なバージョンを指定するにはTo specify a minimum required version for the application

  1. ソリューション エクスプローラーでプロジェクトを選択し、 [プロジェクト] メニューの [プロパティ] をクリックします。With a project selected in Solution Explorer, on the Project menu, click Properties.

  2. [発行] タブをクリックします。Click the Publish tab.

  3. [更新] ボタンをクリックして、 [アプリケーションの更新] ダイアログボックスを開きます。Click the Updates button to open the Application Updates dialog box.

  4. [アプリケーションの更新プログラム] ダイアログボックスで、 [アプリケーションの更新プログラムを確認する] チェックボックスがオンになっていることを確認します。In the Application Updates dialog box, make sure that the The application should check for updates check box is selected.

  5. [このアプリケーションに最低限必要なバージョンを指定する] チェックボックスをオンにして、アプリケーションのメジャー番号、マイナー番号、ビルド番号、リビジョン番号を入力します。Select the Specify a minimum required version for this application check box, and then enter Major, Minor, Build, and Revision numbers for the application.

別の更新プログラムの場所を指定するにはTo specify a different update location

  1. ソリューション エクスプローラーでプロジェクトを選択し、 [プロジェクト] メニューの [プロパティ] をクリックします。With a project selected in Solution Explorer, on the Project menu, click Properties.

  2. [発行] タブをクリックします。Click the Publish tab.

  3. [更新] ボタンをクリックして、 [アプリケーションの更新] ダイアログボックスを開きます。Click the Updates button to open the Application Updates dialog box.

  4. [アプリケーションの更新プログラム] ダイアログボックスで、 [アプリケーションの更新プログラムを確認する] チェックボックスがオンになっていることを確認します。In the Application Updates dialog box, make sure that the The application should check for updates check box is selected.

  5. [更新の場所] フィールドに、完全修飾 URL を使用して更新の場所を http://Hostname/ApplicationName 入力します。その際、形式を使用します。または、 *\ \ \ * の形式で UNC パスを入力するか、 [参照] ボタンをクリックして、更新プログラムの場所。In the Update location field, enter the update location with a fully qualified URL, using the format http://Hostname/ApplicationName, or a UNC path using the format \\Server\ApplicationName, or click the Browse button to browse for the update location.

プログラムによって更新プログラムをチェックするにはTo check for updates programmatically

  1. ソリューション エクスプローラーでプロジェクトを選択し、 [プロジェクト] メニューの [プロパティ] をクリックします。With a project selected in Solution Explorer, on the Project menu, click Properties.

  2. [発行] タブをクリックします。Click the Publish tab.

  3. [更新] ボタンをクリックして、 [アプリケーションの更新] ダイアログボックスを開きます。Click the Updates button to open the Application Updates dialog box.

  4. [アプリケーションの更新プログラム] ダイアログボックスで、 [アプリケーションが更新プログラムを確認する必要が] ある チェックボックスがオフになっていることを確認します。In the Application Updates dialog box, make sure that the The application should check for updates check box is cleared. (必要に応じて、このチェックボックスをオンにすると、プログラムによって更新プログラムがチェックされ、ClickOnce ランタイムが更新プログラムを自動的にチェックできるようになります)。(Optionally, you can select this check box to check for updates programmatically and also let the ClickOnce runtime check for updates automatically.)

  5. [更新の場所] フィールドに、完全修飾 URL を使用して更新の場所を http://Hostname/ApplicationName 入力します。その際、形式を使用します。または、 *\ \ \ * の形式で UNC パスを入力するか、 [参照] ボタンをクリックして、更新プログラムの場所。In the Update location field, enter the update location with a fully qualified URL, using the format http://Hostname/ApplicationName, or a UNC path using the format \\Server\ApplicationName, or click the Browse button to browse for the update location. 更新プログラムの場所は、アプリケーションが更新されたバージョンを検索する場所です。The update location is where the application will look for an updated version of itself.

  6. ユーザーが更新プログラムをチェックするために選択する、Windows フォーム上のボタン、メニュー項目、またはその他のユーザーインターフェイス項目を作成します。Create a button, menu item, or other user interface item on a Windows Form that users will select to check for updates. その項目のイベントハンドラーから、メソッドを呼び出して更新プログラムを確認し、インストールします。From that item's event handler, call a method to check for and install updates. このようなメソッドの Visual Basic とビジュアルC#コードの例については、「」を参照してください。ClickOnce 配置 APIを使用して、プログラムによってアプリケーションの更新プログラムを確認します。You can find an example of Visual Basic and Visual C# code for such a method in How to: Check for application updates programmatically using the ClickOnce deployment API.

  7. アプリケーションをビルドします。Build your application.

関連項目See also