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

2025-06-12

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

注

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

発行場所を指定する

ClickOnce を使用してアプリケーションを発行する場合、 Publish Location プロパティは、アプリケーションファイルとマニフェストを配置する場所を指定します。これには、ドライブパス (C:\deploy\myapplication)、ファイル共有 (\\server\myapplication)、FTP サーバー (ftp://ftp.microsoft.com/myapplication) を指定できます。参照 (...) ボタンを機能させるには、[発行場所] ボックスにテキストが表示されている必要があります。

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

注

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

ソリューションエクスプローラーでプロジェクトを選択した状態で、[プロジェクト] メニューの [プロパティ] をクリックします。
[ 発行 ] タブをクリックします。
[ 発行場所 ] フィールドに、次のいずれかの形式で発行場所を入力します。
- ファイル共有またはディスクパスに発行するには、UNC パス (\\Server\ApplicationName) またはファイルパス (C:\Deploy\ApplicationName) を使用してパスを入力します。
- FTP サーバーに発行するには、/<ApplicationName>ftp://ftp.microsoft.com 形式を使用してパスを入力します。
  
  [参照] (...) ボタンを機能させるには、[発行場所] ボックスにテキストが表示されている必要があります。

エンドユーザーのインストール先の場所を指定する

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

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

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

注

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

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

ソリューションエクスプローラーでプロジェクトを選択した状態で、[プロジェクト] メニューの [プロパティ] をクリックします。
[ 発行 ] タブをクリックします。
[インストール URL] フィールドに、形式 https://www.contoso.com/ApplicationNameを使用して完全修飾 URL を使用してインストール場所を入力するか、形式 \Server\ApplicationNameを使用して UNC パスを入力します。

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

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

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

注

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

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

ソリューションエクスプローラーでプロジェクトを選択した状態で、[プロジェクト] メニューの [プロパティ] をクリックします。
[ 発行 ] タブをクリックします。
[ インストールモードと設定] 領域で、[ アプリケーションはオンラインでのみ使用できる ] オプションボタンをクリックします。

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

ソリューションエクスプローラーでプロジェクトを選択した状態で、[プロジェクト] メニューの [プロパティ] をクリックします。
[ 発行 ] タブをクリックします。
[ インストールモードと設定] 領域で、[ アプリケーションはオフラインでも使用できます ] オプションボタンをクリックします。

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

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

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

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

バージョン番号が変更されると、アプリケーションは更新プログラムとして発行されます。発行バージョン (メジャー、 マイナー、 ビルド、 リビジョン) の各部分の最大値は 65535 (MaxValue)、 Versionで許可される最大値です。

注

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

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

ソリューションエクスプローラーでプロジェクトを選択した状態で、[プロジェクト] メニューの [プロパティ] をクリックします。
[ 発行 ] タブをクリックします。
[ 発行バージョン ] フィールドで、 メジャー、 マイナー、 ビルド、または リビジョンの バージョン番号をインクリメントします。

注

バージョン番号は決して減らさないでください。これにより、予期しない更新動作が発生する可能性があります。

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

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

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

注

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

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

ソリューションエクスプローラーでプロジェクトを選択した状態で、[プロジェクト] メニューの [プロパティ] をクリックします。
[ 発行 ] タブをクリックします。
[ 発行バージョン ] セクションで、[ リリースごとにリビジョンを自動的にインクリメント する] チェックボックスをオフにします。

ClickOnce アプリケーションの発行ページを指定する

ClickOnce アプリケーションを発行すると、既定の Web ページ (publish.htm) が生成され、アプリケーションと共に発行されます。このページには、アプリケーションの名前、アプリケーションや前提条件をインストールするためのリンク、ClickOnce について説明するヘルプトピックへのリンクが含まれています。プロジェクトの [発行ページ] プロパティを使用すると、ClickOnce アプリケーションの Web ページの名前を指定できます。

発行ページが指定されると、次回発行するときに発行場所にコピーされます。再度発行しても上書きされません。ページの外観をカスタマイズする場合は、変更を失うことを心配せずにカスタマイズできます。詳細については、「 ClickOnce の既定の Web ページをカスタマイズする」を参照してください。

[発行ページ] プロパティは、プロジェクトデザイナーの [発行] ウィンドウからアクセスできる [発行オプション] ダイアログボックスで設定できます。

ClickOnce アプリケーションのカスタム Web ページを指定するには:

ソリューションエクスプローラーでプロジェクトを選択した状態で、[プロジェクト] メニューの [プロパティ] をクリックします。
[ 発行 ] ウィンドウを選択します。
[ オプション ] ボタンをクリックして、[ 発行オプション] ダイアログボックスを開きます。
[ デプロイ] をクリックします。
[ 発行オプション] ダイアログボックスで、[ 発行後にデプロイ Web ページを開く ] チェックボックスがオンになっていることを確認します (既定でオンにする必要があります)。
[ デプロイ Web ページ ] ボックスに Web ページの名前を入力し、[OK] をクリック します。

発行するたびに発行ページが起動しないようにするには:

ソリューションエクスプローラーでプロジェクトを選択した状態で、[プロジェクト] メニューの [プロパティ] をクリックします。
[ 発行 ] ウィンドウを選択します。
[ オプション ] ボタンをクリックして、[ 発行オプション] ダイアログボックスを開きます。
[ デプロイ] をクリックします。
[ 発行オプション] ダイアログボックスで、[ 発行後にデプロイ Web ページを開く ] チェックボックスをオフにします。

ClickOnce アプリケーションの既定の Web ページをカスタマイズする

ClickOnce アプリケーションを Web に発行すると、Web ページが自動的に生成され、アプリケーションと共に発行されます。既定のページには、アプリケーションの名前と、アプリケーションのインストール、前提条件のインストール、または MSDN のヘルプへのアクセスに関するリンクが含まれています。

注

ページに表示される実際のリンクは、ページが表示されているコンピューターと、含める前提条件によって異なります。

Web ページの既定の名前は Publish.htmです。 プロジェクトデザイナーで名前を変更できます。詳細については、「 ClickOnce アプリケーションの発行ページを指定する」を参照してください。

Publish.htm Web ページは、新しいバージョンが検出された場合にのみ発行されます。

注

発行設定に加えた変更は、Publish.htm ページには影響しません。ただし、最初に発行した後に前提条件を追加または削除した場合、前提条件の一覧は正確ではなくなります。変更を反映するには、前提条件リンクのテキストを編集する必要があります。

発行 Web ページをカスタマイズするには:

ClickOnce アプリケーションを Web上の場所に公開します。詳細については、「方法: 発行ウィザードを使用して ClickOnce アプリケーションを発行する」を参照してください。
Web サーバーで、Visual Web Designer または別の HTML エディターで Publish.htm ファイルを開きます。
必要に応じてページをカスタマイズして保存します。
任意。カスタマイズした発行 Web ページが Visual Studio によって上書きされないようにするには、[発行オプション] ダイアログボックスの [発行のたびにデプロイ Web ページを自動的に生成する] チェックボックスをオフにします。

テクニカルサポートのリンクを指定する

ClickOnce アプリケーションを発行する場合、 サポート URL プロパティは、ユーザーがアプリケーションに関する情報を取得するために移動できる Web ページまたはファイル共有を識別します。このプロパティは省略可能です。指定した場合は、アプリケーションのエントリ [ プログラムの追加と削除 ] ダイアログボックスに URL が表示されます。

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

サポート URL を指定するには:

ソリューションエクスプローラーでプロジェクトを選択した状態で、[プロジェクト] メニューの [プロパティ] をクリックします。
[ 発行 ] タブをクリックします。
[ オプション ] ボタンをクリックして、[ 発行オプション] ダイアログボックスを開きます。
[ 説明] をクリックします。
[ サポート URL ] フィールドに、Web サイト、Web ページ、または UNC 共有への完全修飾パスを入力します。

ClickOnce 配置で個々の前提条件のサポート URL を指定する

ClickOnce 配置では、ClickOnce アプリケーションを実行するためにクライアントコンピューターで使用できる必要があるいくつかの前提条件をテストできます。これらの依存関係には、必要な最小バージョンの .NET Framework、オペレーティングシステムのバージョン、グローバルアセンブリキャッシュ (GAC) にプレインストールする必要があるアセンブリが含まれます。ただし、ClickOnce では、これらの前提条件自体をインストールできません。前提条件が見つからない場合は、インストールを停止するだけで、インストールが失敗した理由を説明するダイアログボックスが表示されます。

前提条件をインストールする方法は 2 つあります。ブートストラップアプリケーションを使用してインストールできます。または、個々の前提条件のサポート URL を指定することもできます。この URL は、前提条件が見つからない場合にダイアログボックスにユーザーに表示されます。その URL によって参照されるページには、必要な前提条件をインストールするための手順へのリンクを含めることができます。アプリケーションで個々の前提条件のサポート URL が指定されていない場合、ClickOnce はアプリケーション全体の配置マニフェストで指定されたサポート URL (定義されている場合) を表示します。

Visual Studio、 Mage.exe、 およびMageUI.exe はすべて ClickOnce 配置の生成に使用できますが、これらのツールはいずれも、個々の前提条件のサポート URL の指定を直接サポートしません。このドキュメントでは、これらのサポート URL を含むように配置のアプリケーションマニフェストと配置マニフェストを変更する方法について説明します。

注

個々の前提条件のサポート URL を指定する

テキストエディターで ClickOnce アプリケーションのアプリケーション マニフェスト (.manifest ファイル) を開きます。

オペレーティングシステムの前提条件として、 supportUrl 属性を dependentOS 要素に追加します。

 <dependency>
    <dependentOS supportUrl="http://www.adatum.com/MyApplication/wrongOSFound.htm">
      <osVersionInfo>
        <os majorVersion="5" minorVersion="1" buildNumber="2600" servicePackMajor="0" servicePackMinor="0" />
      </osVersionInfo>
    </dependentOS>
  </dependency>

特定のバージョンの共通言語ランタイムの前提条件として、共通言語ランタイムの依存関係を指定する supportUrl エントリに dependentAssembly 属性を追加します。

  <dependency>
    <dependentAssembly dependencyType="preRequisite" allowDelayedBinding="true" supportUrl=" http://www.adatum.com/MyApplication/wrongClrVersionFound.htm">
      <assemblyIdentity name="Microsoft.Windows.CommonLanguageRuntime" version="4.0.30319.0" />
    </dependentAssembly>
  </dependency>

グローバルアセンブリキャッシュにプレインストールする必要があるアセンブリの前提条件として、必要なアセンブリを指定するsupportUrl要素のdependentAssemblyを設定します。

  <dependency>
    <dependentAssembly dependencyType="preRequisite" allowDelayedBinding="true" supportUrl=" http://www.adatum.com/MyApplication/missingSampleGACAssembly.htm">
      <assemblyIdentity name="SampleGACAssembly" version="5.0.0.0" publicKeyToken="04529dfb5da245c5" processorArchitecture="msil" language="neutral" />
    </dependentAssembly>
  </dependency>

任意。 .NET Framework 4 を対象とするアプリケーションの場合は、テキストエディターで ClickOnce アプリケーションの配置マニフェスト ( .application ファイル) を開きます。

.NET Framework 4 の前提条件として、supportUrl要素に compatibleFrameworks 属性を追加します。

<compatibleFrameworks  xmlns="urn:schemas-microsoft-com:clickonce.v2" supportUrl="http://adatum.com/MyApplication/CompatibleFrameworks.htm">
  <framework targetVersion="4.0" profile="Client" supportedRuntime="4.0.30319" />
  <framework targetVersion="4.0" profile="Full" supportedRuntime="4.0.30319" />
</compatibleFrameworks>

アプリケーションマニフェストを手動で変更したら、デジタル証明書を使用してアプリケーションマニフェストに再署名し、配置マニフェストも更新して再署名する必要があります。このタスクを実行するには、Mage.exeまたはMageUI.exe SDK ツールを使用してください。Visual Studioでこれらのファイルを再生成すると、手動で行った変更が消去されます。 Mage.exe を使用してマニフェストに再署名する方法の詳細については、「方法: アプリケーションマニフェストと配置マニフェストに再署名する」を参照してください。

.NET Framework のセキュリティ

アプリケーションが部分信頼で実行されるようにマークされている場合、サポート URL はダイアログボックスに表示されません。

注

ClickOnce for .NET Core および .NET 5 以降では、コードアクセスセキュリティを必要とする部分信頼はサポートされていません。 .NET Framework では、コードアクセスセキュリティの使用はベストプラクティスではなく、推奨されません。

ClickOnce アプリケーションの発行言語を変更する

ClickOnce アプリケーションを発行する場合、インストール時に表示されるユーザーインターフェイスは、開発用コンピューターの言語とカルチャに既定で設定されます。ローカライズされたアプリケーションを発行する場合は、ローカライズされたバージョンに合わせて言語とカルチャを指定する必要があります。これは、プロジェクトの Publish language プロパティによって決まります。

Publish languageプロパティは、プロジェクトデザイナーの [発行] ページからアクセスできる [発行オプション] ダイアログボックスで設定できます。

注

発行言語を変更するには:

ソリューションエクスプローラーでプロジェクトを選択した状態で、[プロジェクト] メニューの [プロパティ] をクリックします。
[ 発行 ] タブをクリックします。

注

ClickOnce for .NET Core 3.1 および .NET 5 以降では、発行ウィザードとプロジェクトデザイナーの [発行] ページではなく、発行ツールを使用して配置プロパティを設定します。詳細については、「ClickOnce と ClickOnce for .NET を使用した .NET Windows アプリケーションの配置」を参照してください。
[ オプション ] ボタンをクリックして、[ 発行オプション] ダイアログボックスを開きます。
[ 説明] をクリックします。
[ 発行オプション] ダイアログボックスで、[発行言語] ドロップダウンリストから言語とカルチャを選択し、[OK] をクリック します。

ClickOnce アプリケーションがオンラインとオフラインの両方で使用できるようにインストールされると、[ スタート ] メニューと [ プログラムの追加と削除 ] の一覧にエントリが追加されます。既定では、表示名はアプリケーションアセンブリの名前と同じですが、[発行オプション] ダイアログボックスで [製品名] を設定することで表示名を変更できます。

製品名 は publish.htm ページに表示されます。インストールされているオフラインアプリケーションの場合は、[ スタート ] メニューのエントリの名前になり、[ プログラムの追加と削除] にも表示される名前になります。

発行元名は、製品名の上の publish.htm ページに表示され、インストールされているオフラインアプリケーションの場合は、[スタート] メニューにアプリケーションのアイコンが含まれているフォルダーの名前でもあります。

スタートメニューのショートカットまたはアプリ参照は、\Microsoft\Windows\Start Menu\Programs\<publisher 名>%appdata% に作成されます。ショートカットまたはアプリ参照の名前は製品名と同じです。

[発行オプション] ダイアログボックスの [プロジェクト デザイナーの発行] ページで、[製品名] プロパティと [発行元名] プロパティを設定できます。

スタートメニュー名を指定するには:

ソリューションエクスプローラーでプロジェクトを選択した状態で、[プロジェクト] メニューの [プロパティ] をクリックします。
[ 発行 ] タブをクリックします。
[ オプション ] ボタンをクリックして、[ 発行オプション] ダイアログボックスを開きます。
[ 説明] をクリックします。
[ 発行オプション] ダイアログボックスで、[製品名] に表示する名前を入力します。
必要に応じて、パブリッシャー名にパブリッシャー名を入力できます。

CD インストールの自動開始を有効にする

CD-ROM や DVD-ROM などのリムーバブルメディアを使用して ClickOnce アプリケーションを配置する場合は、メディアの挿入時に ClickOnce アプリケーションが自動的に起動されるように、 AutoStart を有効にすることができます。

AutoStartは、プロジェクトデザイナーの [発行] ページで有効にすることができます。

自動開始を有効にするには:

ソリューションエクスプローラーでプロジェクトを選択した状態で、[プロジェクト] メニューの [プロパティ] をクリックします。
[ 発行 ] タブをクリックします。
[オプション] ボタンをクリックします。

[ 発行オプション] ダイアログボックスが表示されます。
[ デプロイ] をクリックします。
[ CD をインストールする場合は、CD が挿入されたときにセットアップを自動的に開始 する] チェックボックスをオンにします。

Autorun.inf ファイルは、アプリケーションの発行時に発行場所にコピーされます。