.NET Framework 配置ガイド (開発者向け)

この記事では、.NET Framework 4.5 から .NET Framework 4.8 までの任意のバージョンの .NET Framework を、それぞれのアプリと共にインストールする開発者向けの情報を提供します。

.NET Framework の再頒布可能パッケージと言語パックは、次のダウンロード ページからダウンロードできます。

• .NET Framework 4.8.1
• .NET Framework 4.8
• .NET Framework 4.7.2
• .NET Framework 4.7.1
• .NET Framework 4.7
• .NET Framework 4.6.2
• .NET Framework 4.6.1
• .NET Framework 4.6
• .NET Framework 4.5.2
• .NET Framework 4.5.1
• .NET Framework 4.5

重要なメモ:

• .NET Framework 4.5.1 から .NET Framework 4.8 までの .NET Framework のバージョンは、.NET Framework 4.5 へのインプレース更新です。つまり、同じバージョンのランタイムを使用しますが、アセンブリのバージョンが更新され、新しい型とメンバーが含まれます。

• .NET Framework 4.5 以降のバージョンは、.NET Framework 4 の上にインクリメンタル方式でビルドされます。 .NET Framework 4 がインストールされたシステムに .NET Framework 4.5 以降のバージョンをインストールすると、バージョン 4 のアセンブリが新しいバージョンに置き換えられます。

• アプリで Microsoft 帯域外のパッケージ を参照している場合、アセンブリはアプリのパッケージに組み込まれます。

• .NET Framework 4.5 以降のバージョンをインストールするには、管理者特権が必要です。

• .NET Framework 4.5 は、Windows 8 と Windows Server 2012 に含まれているため、これらのオペレーティング システムではアプリと一緒に配置する必要はありません。 同様に、.NET Framework 4.5.1 は Windows 8.1 と Windows Server 2012 R2 に含まれます。 .NET Framework 4.5.2 はどのオペレーティング システムにも含まれていません。 .NET Framework 4.6 は Windows 10 に含まれます。 .NET Framework 4.6.1 は Windows 10 November Update に含まれます。 .NET Framework 4.6.2 は Windows 10 Anniversary Update に含まれます。 .NET Framework 4.7 は Windows 10 Creators Update に、.NET Framework 4.7.1 は Windows 10 Fall Creators Update に、.NET Framework 4.7.2 は Windows 10 October 2018 Update と Windows 10 April 2018 Update にそれぞれ含まれます。 .NET Framework 4.8 は、Windows 10 May 2019 Update と、それ以降のすべての Windows 10 更新プログラムに含まれています。 ハードウェア要件とソフトウェア要件の一覧については、「システム要件」を参照してください。

• .NET Framework 4.5 以降では、ユーザーはセットアップ中に、実行されている .NET Framework アプリケーションの一覧を表示し、簡単に終了できます。 これにより、.NET Framework のインストールによるシステムの再起動を回避できます。 「 システム再起動の削減」を参照してください。

• .NET Framework 4.5 以降のバージョンをアンインストールすると、前に存在していた .NET Framework 4 ファイルも削除されます。 .NET Framework 4 に戻る場合は、そのバージョンとすべての更新プログラムを再インストールする必要があります。 「.NET Framework 4 のインストール」を参照してください。

• .NET Framework 4.5 再頒布可能パッケージは、2012 年 10 月 9 に更新されています。この更新により、Microsoft によって生成および署名されたファイルへのデジタル署名が途中で有効期限切れになるという、デジタル証明書の不適切なタイムスタンプに関連する問題が解決しました。 2012 年 8 月 16 日付けの .NET Framework 4.5 再頒布可能パッケージを以前にインストールしていた場合は、.NET Framework ダウンロード ページから最新の再頒布可能パッケージを入手して更新することをお勧めします。 この問題について詳しくは、「 マイクロソフト セキュリティ アドバイザリ (2749655)」をご覧ください。

システム管理者が .NET Framework とそのシステムの依存関係をネットワーク経由で配置する方法については、管理者向け配置ガイドに関するページを参照してください。

アプリケーションの配置オプション

ユーザーがアプリケーションをインストールできるように Web サーバーまたは他の一元的な場所にアプリケーションを発行する準備ができたら、複数の配置方法から選択できます。 これらの一部は、Visual Studio に装備されています。 次の表に、アプリケーションの配置オプションの一覧と、各オプションをサポートする .NET Framework 再頒布可能パッケージを示します。 これらに加えて、アプリケーション用のカスタム セットアップ プログラムを作成できます。詳細については、「 アプリケーションのセットアップへの .NET Framework のインストールのチェーン」を参照してください。

再頒布可能パッケージ

.NET Framework は、Web インストーラー (ブートストラップ) とオフライン インストーラー (スタンドアロン再頒布可能パッケージ) の 2 種類の再頒布可能パッケージで入手できます。 すべての .NET Framework ダウンロードは、.NET Framework ダウンロード ページ上でホストされています。 2 つのパッケージの比較を次の表に示します。

* オフライン インストーラーは、すべての対象プラットフォームのコンポーネントを含むため、より大きくなっています。 セットアップの実行が終了すると、Windows オペレーティング システムは使用されたインストーラーのみキャッシュします。 オフライン インストーラーがインストール後に削除されると、使用されるディスク領域は Web インストーラーに使用される領域と同じになります。 アプリのセットアップ プログラムの作成に使用するツール (たとえば、InstallAware または InstallShield) によって、インストール後に削除されるセットアップ ファイル フォルダーが提供される場合は、オフライン インストーラーをそのセットアップ フォルダー内に配置することで自動的に削除できます。

** カスタム設定の Web インストーラーを使用する場合は、ユーザーの複数言語ユーザー インターフェイス (MUI) 設定に基づいて既定の言語設定を使用するか、コマンド ラインで /LCID オプションを使用して別の言語パックを指定できます。 例については、「 既定の .NET Framework の UI を使用したチェーン 」を参照してください。

配置方法

4 つの配置方法を使用できます。

• .NET Framework の依存関係を設定できます。 これらのメソッドのいずれかを使用して、アプリケーションのインストールで必須コンポーネントとして .NET Framework を指定できます。

  • ClickOnce 配置 を使用します (Visual Studio で使用可能)

  • InstallAware プロジェクトを作成します (Visual Studio ユーザーが使用できる無償のエディション)

  • InstallShield プロジェクト を作成します (Visual Studio で使用可能)

  • Windows インストーラー XML (WiX) ツール セットを使用します。

• .NET Framework を手動でインストールするようにユーザーに依頼できます。

• アプリケーションのセットアップに .NET Framework セットアップ プロセスをチェイン (インクルード) して、.NET Framework のインストール環境をどのように処理するかを決定できます。

  • 既定の UI を使用します。 .NET Framework のインストーラーによりインストール環境が提供されます。

  • UI をカスタマイズ して、一元化されたインストール エクスペリエンスを提供し、.NET Framework のインストールの進行状況を監視します。

これらの配置方法の詳細については、以降のセクションで説明します。

.NET Framework の依存関係を設定する

アプリケーションの配置に ClickOnce、InstallAware、InstallShield、または WiX を使用した場合、.NET Framework の依存関係を追加して、アプリケーションの一部としてインストールできます。

ClickOnce 配置

ClickOnce 配置は、Visual Basic および Visual C# を使用して作成したプロジェクトに使用できますが、Visual C++ には使用できません。

Visual Studio で ClickOnce 配置を選択し、.NET Framework の依存関係を追加するには:

1. 発行するアプリケーション プロジェクトを開きます。

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

3. [発行] ペインを選択します。

4. [必須コンポーネント] ボタンをクリックします。

5. [必須コンポーネント] ダイアログ ボックスの [必須コンポーネントをインストールするセットアップ プログラムを作成する] チェック ボックスをオンにします。

6. 必須コンポーネントの一覧で、プロジェクトのビルドに使用した .NET Framework のバージョンを検索して選択します。

7. 必須コンポーネントのソースの場所を指定するオプションを選択し、 [OK] をクリックします。

   .NET Framework のダウンロード場所の URL を指定する場合は、.NET Framework ダウンロード ページまたは独自のサイトを指定できます。 再頒布可能パッケージを独自のサーバーに配置する場合は、Web インストーラーではなく、オフライン インストーラーを使用する必要があります。 .NET Framework ダウンロード ページ上の Web インストーラーにのみリンクできます。 URL には、独自のアプリケーションを配布する CD を指定することもできます。

8. [プロパティ ページ] ダイアログ ボックスの [OK] をクリックします。

InstallAware の配置

InstallAware は、Windows アプリ (APPX)、Windows インストーラー (MSI)、ネイティブ コード (EXE)、および App-V (アプリケーションの仮想化) パッケージを、1 つのソースからビルドします。 必要に応じて既定のスクリプトを編集してインストールをカスタマイズし、任意のバージョンの .NET Framework を含めることが簡単にできます。 たとえば、InstallAware は Windows 7 に証明書をあらかじめインストールします (これがない場合、.NET Framework 4.7 のセットアップは失敗します)。 InstallAware の詳細については、Windows インストーラー用 InstallAware の Web サイトをご覧ください。

InstallShield 配置

InstallShield では、Windows アプリ パッケージ (MSIX、APPX)、Windows インストーラー パッケージ (MSI) および Native Code (EXE) インストーラをビルドできます。 InstallShield では、Visual Studio の統合も可能です。 詳細については、InstallShield の Web サイトを参照してください。

Windows インストーラー XML (WiX) 配置

Windows インストーラー XML (WiX) ツールセットは、XML ソース コードから Windows インストール パッケージをビルドします。 WiX は、MSI と MSM セットアップ パッケージのビルド処理に統合できるコマンド ライン環境をサポートします。 WiX を使用すると、 .NET Framework を必須コンポーネントとして指定するか、 チェーン元を作成 して、.NET Framework の配置操作を完全制御できます。 WiX について詳しくは、「 Windows インストーラー XML (WiX) ツールセット 」の Web サイトをご覧ください。

.NET Framework を手動でインストールする

アプリと一緒に .NET Framework を自動的にインストールすることが適切でない場合もあります。 そのような場合は、ユーザーが .NET Framework を手動でインストールできます。 頒布可能パッケージは、 2 つのパッケージで使用できます。 セットアップ プロセスでは、.NET Framework を探す方法とインストールする方法についてユーザーに指示する必要があります。

アプリケーションのセットアップへの .NET Framework のインストールのチェーン

アプリケーション用のカスタム セットアップ プログラムを作成する場合、.NET Framework セットアップ プロセスをアプリケーションのセットアップ プロセスにチェーン (インクルード) することができます。 チェーンは、.NET Framework のインストールに次の 2 種類の UI オプションを提供します。

• .NET Framework のインストーラーによって提供される既定の UI を使用します。

• .NET Framework のインストールのカスタム UI を作成して、アプリケーションのセットアップ プログラムとの一貫性を保ちます。

どちらの方法でも、Web インストーラーまたはオフライン インストーラーを使用できます。 各パッケージには長所があります。

• Web インストーラーを使用した場合、.NET Framework セットアップ プロセスが必要なインストール パッケージを判断し、そのパッケージだけを Web サイトからダウンロードしてインストールします。

• オフライン インストーラーを使用すると、再頒布可能メディアに .NET Framework インストール パッケージの完全なセットを入れることができ、ユーザーがセットアップ中に Web から追加ファイルをダウンロードする必要がなくなります。

既定の .NET Framework の UI を使用したチェーン

.NET Framework インストール プロセスをサイレントにチェーンして .NET Framework のインストーラーに UI を提供させるには、セットアップ プログラムに次のコマンドを追加します。

<.NET Framework redistributable> /q /norestart /ChainingPackage <PackageName>

たとえば、実行可能プログラムが Contoso.exe で、.NET Framework 4.5 のオフライン再頒布可能パッケージをサイレント インストールする場合は、次のコマンドを使用します。

dotNetFx45_Full_x86_x64.exe /q /norestart /ChainingPackage Contoso

追加のコマンド ライン オプションを使用して、インストールをカスタマイズできます。 次に例を示します。

• システムの再起動を最小限に抑えるために、実行中の .NET Framework アプリケーションを終了する方法をユーザーに提供するには、受動モードを設定して、次のように /showrmui オプションを使用します。

  dotNetFx45_Full_x86_x64.exe /norestart /passive /showrmui /ChainingPackage Contoso

  このコマンドは、.NET Framework をインストールする前に、.NET Framework アプリを終了する機会をユーザーに与えるメッセージ ボックスを、再起動マネージャーが表示できるようにします。

• Web インストーラーを使用する場合、 /LCID オプションを使用して言語パックを指定できます。 たとえば、.NET Framework 4.5 Web インストーラーを Contoso セットアップ プログラムにチェーンして日本語の言語パックをインストールするには、次のコマンドをアプリのセットアップ プロセスに追加します。

  dotNetFx45_Full_setup.exe /q /norestart /ChainingPackage Contoso /LCID 1041

  /LCID オプションを省略すると、セットアップはユーザーの MUI 設定と一致する言語パックをインストールします。

  Note

  言語パックのリリース日は、それぞれ異なっている場合があります。 指定した言語パックがダウンロード センターで入手できない場合、セットアップは言語パックなしで .NET Framework をインストールします。 .NET Framework がユーザーのコンピューターに既にインストールされている場合、セットアップは言語パックだけをインストールします。

オプションの完全なリストについては、「 コマンド ライン オプション 」を参照してください。

共通の戻りコードについては、「 戻りコード 」を参照してください。

カスタム UI を使用したチェーン

カスタム セットアップ パッケージがある場合、セットアップの進行状況のビューを独自に表示する一方で、.NET Framework のセットアップをサイレントで起動および追跡できます。 この場合は、コードが次をカバーしていることを確認します。

• .NET Framework のハードウェア要件とソフトウェア要件のチェック。

• .NET Framework の正しいバージョンがユーザーのコンピューターに既にインストールされているかどうかの検出 。

  重要

  正しいバージョンの .NET Framework が既にインストールされているかどうかを判断するには、ターゲット バージョンがインストールされているかどうかではなく、ターゲット バージョン または それ以降のバージョンがインストールされているかどうかを確認する必要があります。 言い換えると、レジストリから取得したリリース キーがターゲット バージョンのリリース キーと 同じかどうかを確認するのではなく 、ターゲット バージョンのリリース キーと同じか、それ以降になっているかどうかを確認する必要があります。

• 言語パックがユーザーのコンピューターに既にインストールされているかどうかの検出 。

• 配置を制御する場合は、.NET Framework セットアップ プロセスをサイレントに起動および追跡 (「方法:.NET Framework 4.5 インストーラーの進行状況を表示する」をご覧ください)。

• オフライン インストーラーを配置する場合は、 言語パックを個別にチェーンします。

• コマンド ライン オプションを使用した配置のカスタマイズ。 たとえば、.NET Framework Web インストーラーをチェーンして、既定の言語パックをオーバーライドする場合は、前のセクションで説明したように /LCID オプションを使用します。

• トラブルシューティング。

.NET Framework を検出する

.NET Framework のインストーラーは、インストールが成功するとレジストリ キーを書き込みます。 .NET Framework 4.5 またはそれ以降がインストールされているかどうかは、Release という名前の DWORD 値のレジストリで HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full フォルダーを確認することでテストできます。 ("NET Framework セットアップ" の先頭ががピリオドではないことに注意してください)。このキーがある場合は、.NET Framework 4.5 またはそれ以降のバージョンがそのコンピューターにインストールされていることを示しています。 Release の値は、インストールされている .NET Framework のバージョンを示します。

言語パックを検出する

Release という名前の DWORD 値のレジストリで HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full\LCID フォルダーをチェックすることにより、特定の言語パックがインストールされているかどうかをテストできます。 ("NET Framework セットアップ" の先頭ががピリオドではないことに注意してください)。LCID はロケール識別子を指定します。これらのリストについては、「サポートされる言語」を参照してください。

たとえば、完全な日本語言語パック (LCID=1041) がインストールされているかどうかを検出するには、レジストリから次の名前付きの値を取得します。

言語パックの最終リリース バージョンがバージョン 4.5 から 4.7.2 までの特定のバージョンの .NET Framework にインストールされているかどうかを確認するには、前のセクション「.NET Framework の検出」で説明した Release キー DWORD の値を確認します。

アプリケーション セットアップへの言語パックのチェーン

.NET Framework には、特定のカルチャにローカライズされたリソースを含むスタンドアロンの言語パックの実行可能ファイルのセットが用意されています。 言語パックは .NET Framework のダウンロード ページから入手できます。

• .NET Framework 4.8.1
• .NET Framework 4.8
• .NET Framework 4.7.2
• .NET Framework 4.7.1
• .NET Framework 4.7
• .NET Framework 4.6.2
• .NET Framework 4.6.1
• .NET Framework 4.6
• .NET Framework 4.5.2
• .NET Framework 4.5.1
• .NET Framework 4.5

.NET Framework 4.5.1 以降では、パッケージ名の形式は NDP<version>-KB<number>-x86-x64-AllOS-<culture>.exe になります。version は .NET Framework のバージョン番号です。number は Microsoft ナレッジ ベース記事番号です。culture は国またはリージョンを指定します。 これらのパッケージの一例は、 NDP452-KB2901907-x86-x64-AllOS-JPN.exeです。 パッケージ名はこの記事の既出の Redistributable Packages セクションに記載されています。

.NET Framework のオフライン インストーラーを言語パックと一緒にインストールするには、言語パックをアプリのセットアップにチェーンする必要があります。 たとえば、.NET Framework 4.5.1 のオフライン インストーラーを日本語言語パックと一緒に配置するには、次のコマンドを使用します。

NDP451-KB2858728-x86-x64-AllOS-JPN.exe /q /norestart /ChainingPackage <ProductName>

Web インストーラーを使用する場合は、言語パックをチェーンする必要はありません。セットアップはユーザーの MUI 設定と一致する言語パックをインストールします。 異なる言語をインストールするには、 /LCID オプションを使用して言語パックを指定します。

コマンド ライン オプションの完全なリストについては、「 コマンド ライン オプション 」を参照してください。

トラブルシューティング

戻りコード

次の表は、.NET Framework の再頒布可能インストーラーから返される最も一般的なリターン コードを示しています。 これらのリターン コードは、すべてのバージョンのインストーラーで共通です。 詳細情報へのリンクについては、次のセクションを参照してください。

ダウンロードのエラー コード

次のコンテンツをご覧ください。

• Background Intelligent Transfer Service (BITS) のエラー コード

• URL モニカーのエラー コード

• WinHttp エラー コード

その他のエラー コード

次のコンテンツをご覧ください。

• Windows インストーラーのエラー コード

• Windows Update エージェントの結果コード

.NET Framework をアンインストールする

Windows 8 以降、コントロール パネルの [Windows の機能の有効化または無効化] を使用して、.NET Framework 4.5 以降のバージョンをアンインストールできます。 Windows の旧バージョンでは、コントロール パネルの [プログラムの追加と削除] を使用して .NET Framework 4.5 以降のバージョンをアンインストールできます。

付録

コマンド ライン オプション

次の表では、アプリケーションのセットアップに .NET Framework 4.5 の再頒布可能パッケージをチェーンするときに指定できるオプションを示します。

サポートされる言語

.NET Framework 4.5 以降のバージョンで使用可能な .NET Framework 言語パックを次の表に示します。

関連項目

• 配置ガイド (管理者向け)
• システム要件
• 開発者向けの .NET Framework のインストール
• .NET Framework のインストールおよびアンインストールのブロックのトラブルシューティング
• .NET Framework 4.5 のインストール中のシステム再起動の削減
• 方法: .NET Framework 4.5 インストーラーの進行状況を表示する