ClickOnce 発行プロパティを指定する

ClickOnce 発行プロパティは、プロジェクト デザイナー[発行]ページで、または発行ウィザードを使用して構成できます。 この記事では、発行場所、インストール URL、オンラインまたはオフライン インストール モード、発行バージョンなどの基本的なプロパティを指定する方法について説明します。

発行場所を指定する

ClickOnce を使用してアプリケーションを発行する場合、Publish Location プロパティによってアプリケーション ファイルとマニフェストが配置される場所が指定されます。 これには、ファイル パスまたは FTP サーバーへのパスを指定できます。

[プロジェクト デザイナー][発行] ページで、または、発行ウィザードを使用して Publish Location プロパティを指定することができます。 詳細については、「方法: 発行ウィザードを使用して ClickOnce アプリケーションを発行する」を参照してください。

Note

ClickOnce を使用してアプリケーションの複数のバージョンをインストールすると、以前のバージョンのアプリケーションは、指定した発行場所の Archive というフォルダーに移動されます。 以前のバージョンがこのようにアーカイブされることで、インストール ディレクトリが以前のバージョンのフォルダーから分離されます。

  1. ソリューション エクスプローラーでプロジェクトを選択し、 [プロジェクト] メニューの [プロパティ] をクリックします。

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

    Note

    .NET Core 3.1 および .NET 5 以降の ClickOnce では、発行ウィザードやプロジェクト デザイナーの [発行] ページではなく、発行ツールを使用して配置プロパティを設定します。 詳細については、ClickOnce を使用した .NET Windows アプリケーションの配置.NET 用 ClickOnce に関するページを参照してください。

  3. [発行場所] フィールドに、次の形式のいずれかを使用して、発行場所を入力します。

    • ファイル共有またはディスク パスを発行するには、UNC パス (\\Server\ApplicationName) またはファイル パス (C:\Deploy\ApplicationName) のいずれかを使用して、パスを入力します。

    • FTP サーバーを発行するには、ftp://ftp.microsoft.com/<ApplicationName> という形式を使用して、パスを入力します。

      [発行場所] ボックスでは、テキストは参照 [...] ボタンが機能する順番で並んでいる必要があります。

エンド ユーザーがインストールを開始する場所を指定する

ClickOnce アプリケーションを発行する場合、ユーザーがアプリケーションをダウンロードしてインストールする場所は、必ずしもアプリケーションが最初に発行される場所とは限りません。 たとえば、一部の組織では、開発者がアプリケーションをステージング サーバーに発行した後、管理者がアプリケーションを Web サーバーに移動する場合があります。

この場合、Installation URL プロパティを使用して、ユーザーがアプリケーションをダウンロードするためにアクセスする Web サーバーを指定できます。 これは、アプリケーション マニフェストが更新プログラムを検索する場所を認識するために必要です。

Installation URL プロパティは、プロジェクト デザイナー[発行] ページで設定できます。

Note

Installation URL プロパティは、発行ウィザードを使用して設定することもできます。 詳細については、「方法: 発行ウィザードを使用して ClickOnce アプリケーションを発行する」を参照してください。

インストール URL を指定する

  1. ソリューション エクスプローラーでプロジェクトを選択し、 [プロジェクト] メニューの [プロパティ] をクリックします。

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

    Note

    .NET Core 3.1 および .NET 5 以降の ClickOnce では、発行ウィザードやプロジェクト デザイナーの [発行] ページではなく、発行ツールを使用して配置プロパティを設定します。 詳細については、ClickOnce を使用した .NET Windows アプリケーションの配置.NET 用 ClickOnce に関するページを参照してください。

  3. [インストール URL] フィールドに、形式 https://www.contoso.com/ApplicationName を使用する完全修飾 URL を使用して、または形式 \Server\ApplicationName を使用する UNC パスを使用して、インストールの場所を入力します。

ClickOnce のオフラインまたはオンラインのインストール モードを指定する

ClickOnce アプリケーションの Install Mode は、アプリケーションがオフラインまたはオンラインで利用できるかどうかを決定します。 [アプリケーションをオンラインでのみ利用できる] を選択した場合、ユーザーはアプリケーションを実行するために、ClickOnce 発行場所 (Web ページまたはファイル共有) にアクセスできる必要があります。 [アプリケーションはオフラインでも利用できる] を選択すると、アプリケーションによってエントリが [スタート] メニューと [プログラムの追加と削除] ダイアログ ボックスに追加されます。ユーザーは、接続されていないときにアプリケーションを実行できます。

Install Mode は、プロジェクト デザイナー[発行] ページで設定できます。

Note

Install Mode は、発行ウィザードを使用して設定することもできます。 詳細については、「方法: 発行ウィザードを使用して ClickOnce アプリケーションを発行する」を参照してください。

ClickOnce アプリケーションをオンラインでのみ利用できるようにする

  1. ソリューション エクスプローラーでプロジェクトを選択し、 [プロジェクト] メニューの [プロパティ] をクリックします。

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

    Note

    .NET Core 3.1 および .NET 5 以降の ClickOnce では、発行ウィザードやプロジェクト デザイナーの [発行] ページではなく、発行ツールを使用して配置プロパティを設定します。 詳細については、ClickOnce を使用した .NET Windows アプリケーションの配置.NET 用 ClickOnce に関するページを参照してください。

  3. [インストールモードと設定] 領域で、[アプリケーションはオンラインでのみ利用できる] オプション ボタンをクリックします。

ClickOnce アプリケーションをオンラインまたはオフラインで利用できるようにするには

  1. ソリューション エクスプローラーでプロジェクトを選択し、 [プロジェクト] メニューの [プロパティ] をクリックします。

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

  3. [インストールモードと設定] 領域で、[アプリケーションはオフラインでも利用できる] オプション ボタンをクリックします。

    アプリケーションをインストールすると、[スタート] メニューと [コントロールパネル] の [プログラムの追加と削除] にエントリが追加されます。

ClickOnce の発行バージョンを設定する

ClickOnce の Publish Version プロパティでは、発行するアプリケーションを更新プログラムとして扱うかどうかを指定します。 バージョンがインクリメントされるたびに、アプリケーションは更新プログラムとして発行されます。

Publish Version プロパティは、プロジェクト デザイナー[発行] ページで設定できます。

Note

アプリケーションが発行されるたびに Publish Version プロパティが自動的にインクリメントされるプロジェクト オプションがあります。このオプションは既定で有効になっています。 詳細については、「ClickOnce の発行バージョンを自動的にインクリメントする」を参照してください。

発行バージョンを変更する

  1. ソリューション エクスプ ローラーでプロジェクトを選択し、 [プロジェクト] メニューの [プロパティ]をクリックします。

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

    Note

    .NET Core 3.1 および .NET 5 以降の ClickOnce では、発行ウィザードやプロジェクト デザイナーの [発行] ページではなく、発行ツールを使用して配置プロパティを設定します。 詳細については、ClickOnce を使用した .NET Windows アプリケーションの配置.NET 用 ClickOnce に関するページを参照してください。

  3. [発行するバージョン] フィールドで、[メジャー][マイナー][ビルド]、または [リビジョン] のバージョン番号をインクリメントします。

    Note

    バージョン番号をデクリメントしないでください。これを行うと、予期しない更新動作が発生する可能性があります。

ClickOnce の発行バージョンを自動的にインクリメントする

ClickOnce アプリケーションを発行するとき、Publish Version プロパティを変更すると、そのアプリケーションは更新プログラムとして発行されます。 Visual Studio では既定で、アプリケーションを発行するたびに Publish VersionRevision 番号が自動的にインクリメントされます。

この動作は、プロジェクト デザイナー[発行] ページで無効にできます。

Note

実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。 設定を変更するには、 [ツール] メニューの [設定のインポートとエクスポート] をクリックします。 詳細については、「リセット設定」を参照してください。

発行バージョンの自動インクリメントを無効にする

  1. ソリューション エクスプローラーでプロジェクトを選択し、 [プロジェクト] メニューの [プロパティ] をクリックします。

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

    Note

    .NET Core 3.1 および .NET 5 以降の ClickOnce では、発行ウィザードやプロジェクト デザイナーの [発行] ページではなく、発行ツールを使用して配置プロパティを設定します。 詳細については、ClickOnce を使用した .NET Windows アプリケーションの配置.NET 用 ClickOnce に関するページを参照してください。

  3. [バージョンの発行] セクションで、[リリースごとにリビジョンを自動的に追加する] チェックボックスをオフにします。