Microsoft .NET Framework 3.0 展開ガイド

[アーティクル]
05/11/2010

Microsoft Corporation

2006 年 7 月

内容

まとめ
はじめに
インストール要件
   ソフトウェア要件
   ハードウェア要件
.NET Framework 3.0 再頒布可能パッケージの入手先
Visual Studio 2005 セットアッププロジェクトを使用した .NET Framework 3.0 の再配布
ユーザーが.NET Frameworkを手動でインストールする
アプリケーションセットアップでの再頒布可能パッケージのチェーン
Web アプリケーション.NET Framework 3.0 の再配布
Microsoft .NET Framework 3.0 の検出
   レジストリキーの読み取り
   インターネットエクスプローラーでのユーザーエージェント文字列の読み取り
.NET Framework 3.0 再頒布可能パッケージのコマンドラインオプション
.NET Framework 3.0 再頒布可能パッケージのエラーコード

まとめ

この記事では、.NET Framework 3.0 再頒布可能パッケージである Dotnetfx3.exe を使用して Microsoft .NET Framework 3.0 アプリケーションを展開する方法について説明します。 (10ページ印刷)

メモこのドキュメントには、配布について説明するシナリオに関する情報が含まれる場合がありますが、このドキュメントは、コンポーネントの一部を使用または配布する権限をユーザーに付与するものではありません。お客様による本コンポーネントの使用には、本コンポーネントの使用許諾契約書が適用されます。コンポーネントの使用許諾契約書を確認して、お客様の権利と使用条件を理解してください。

はじめに

Microsoft.NET Framework 3.0 には、.NET Framework 3.0 アプリケーションを実行するために必要な Windows Vista API への.NET Framework 2.0 バインドを含む再頒布可能インストーラーが用意されています。

.NET Framework 3.0 再頒布可能パッケージは、スタンドアロンの実行可能ファイルとして使用できます。ファイルの名前は、対象プラットフォームの種類によって異なります。 32 ビットプラットフォームの場合、ファイルの名前は Dotnetfx3.exe です。 64 ビットプラットフォームの場合、ファイルの名前は Dotnetfx3_x64.exe です。セットアップ中に必要なコンポーネントをダウンロードする Dotnet3setup.exe という名前の小さな再頒布可能パッケージを展開することもできます。

メモ.NET Framework 3.0 での IA64 のサポートは、"Longhorn" という名前の Microsoft Windows Server コードに限定されます。Longhorn には既に.NET Framework 3.0 が含まれているため、再頒布可能パッケージは必要ありません。

再頒布可能パッケージを手動で起動してコンピューターにインストールすることも、.NET Framework 3.0 アプリケーションのセットアッププログラムの一部として起動してインストールすることもできます。

メモ.NET Framework 3.0 をインストールするには、管理者特権が必要です。

インストール要件

このセクションでは、Microsoft .NET Framework 3.0 再頒布可能パッケージをインストールするコンピューターのソフトウェアとハードウェアの要件について説明します。最小要件が満たされていない場合、Dotnetfx3.exeは再頒布可能パッケージのインストールをブロックします。

ソフトウェア要件

Microsoft .NET Framework 3.0 をインストールするには、次のいずれかのオペレーティングシステムをターゲットコンピューターにインストールする必要があります。

Microsoft Windows XP Home または Microsoft Windows XP Professional(Service Pack 2 以降の両方)
Service Pack 1 以降を使用する Microsoft Windows Server 2003 ファミリ。

Microsoft Windows Vista (IA64 プラットフォームを含まない) と"Longhorn" IA64 Edition という名前の Microsoft Windows Server コードの場合、.NET Framework 3.0 はオペレーティングシステムの機能です。

ハードウェア要件

次の表に、.NET Framework 3.0 を実行するためのハードウェア要件を示します。

	CPU が必要	RAM が必要
最小値	Pentium 400 MHz	96 MB
推奨	Pentium 1 GHz 以上	256 MB 以上

.NET Framework 3.0 再頒布可能パッケージの入手先

Microsoft .NET Framework 3.0 再頒布可能パッケージは、Microsoft Vista ダウンロードセンターまたは Microsoft Windows Update Web サイトからダウンロードできます。

メモMicrosoft Windows Update サイトでは、.NET Framework 3.0 の正式にリリースされたバージョンのみが提供されます。ベータ版は提供されていません。

ユーザーにインターネットから Microsoft .NET Framework 3.0 をインストールさせる必要がある場合は、自分のネットワークに再頒布可能パッケージを投稿しないでください。代わりに、ユーザーを Microsoft Vista ダウンロードセンターまたは Microsoft Windows Update Web サイトに誘導します。

Visual Studio 2005 セットアッププロジェクトを使用した .NET Framework 3.0 の再配布

Visual Studio 2005 で作成され、.NET Framework 3.0 が必要なアプリケーションを展開する場合、アプリケーションをインストールする前に、ターゲットコンピューターに.NET Frameworkをインストールする必要があります。 Visual Studio 2005 セットアッププロジェクトを使用して作成するセットアップ実行可能ファイルに、.NET Framework 3.0 を含めることができます。これが実用的でない場合は、後で説明するように、ユーザーに.NET Frameworkを手動でインストールさせることができます。

アプリケーションと共に Microsoft .NET Framework 3.0 をインストールするように Visual Studio 2005 セットアッププロジェクトを構成すると、.NET Framework 3.0 はアプリケーションと共にパッケージ化されます。アプリケーションのセットアップで起動条件が確認 whether.NET Framework 3.0 がインストールされており、必要に応じて、セットアッププロセスによってアプリケーションをインストールする前に.NET Frameworkがインストールされます。 Microsoft .NET Framework 3.0 では、Framework 2.0 がインストール whether.NET チェックされます。そうでない場合は、セットアッププロセスによって、以前のバージョンの.NET Frameworkもインストールするように求められます。

.NET Framework 3.0 をアプリケーションのセットアッププロセスに含めるには、セットアッププロジェクトを作成するコンピューターに、オプションの Visual Studio Extensions for .NET Framework 3.0 をインストールする必要があります。

.NET Framework 3.0 用 Visual Studio 拡張機能がインストールされているかどうかを確認するには

Windows コントロールパネルで、[プログラムの追加と削除] をクリックします。
[プログラムの追加と削除] ダイアログボックスで、Microsoft Visual Studio 2005 Extensions for .NET Framework 3.0 の[現在インストールされているプログラム] の一覧を確認します。

Visual Studio 2005 Extensions for .NET Framework 3.0 が一覧にない場合は、Microsoft ダウンロードセンターの Microsoft Visual Studio Code Name "Orcas" Community Technology Preview – Development Tools for WinFX ページで入手できる、WinFX 用開発ツールの一部として拡張機能パッケージをダウンロードしてインストールできます。

コンピューターに Visual Studio Extensions for .NET Framework 3.0 パッケージがインストールされていることを確認したら、.NET Framework 3.0 を含むセットアッププロジェクトを作成できます。

.NET Framework 3.0 をセットアッププロジェクトに含めるには

Visual Studio 2005 で、次の手順に従って新しいセットアッププロジェクトを作成します。
1. [ ファイル ] メニューの [ 新規作成] をクリックし、[ プロジェクト] をクリックします。
2. [ その他のプロジェクトの種類] で、[ セットアップと配置] を選択します。
3. プロジェクトに名前を付け、[OK] をクリック します。
プロジェクト出力、マージモジュール、ファイル、アセンブリを追加します。
ソリューションエクスプローラーで、プロジェクト名を右クリックし、[プロパティ] をクリックします。

[プロパティページ] ダイアログボックスが表示されます。
[ 前提条件] をクリックします。
[セットアッププログラムを作成して前提条件コンポーネントをインストールするチェック] ボックスを選択します。
一覧で Microsoft .NET Framework 3.0 を見つけて、ターゲットプラットフォームに適したバージョンを選択します。
前提条件のソースの場所を指定します。

.NET Framework 3.0 の場所については、Windows Vista ダウンロードサイトまたは独自のサイトを指定できます。 URL では、独自のアプリケーションを配布する CD を指定することもできます。
[OK] をクリックします。

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

場合によっては、アプリケーションで.NET Framework 3.0 を自動的にインストールするのは現実的でない場合があります。そのような場合は、ユーザーが .NET Framework を手動でインストールできます。再頒布可能パッケージは、「The.NET Framework 3.0 再頒布可能パッケージを入手する場所」セクションで前述したように、複数のソースから入手できます。ただし、アプリケーションのユーザーが入手場所やインストール方法を知っていると想定しないでください。セットアッププロセスでは、.NET Framework を探す方法とインストールする方法についてユーザーに指示する必要があります。

アプリケーションセットアップでの再頒布可能パッケージのチェーン

Visual Studio セットアッププロジェクトを作成しない場合、またはユーザーに.NET Framework 3.0 を手動でインストールさせる場合は、独自のアプリケーションセットアップの一環として、.NET Framework 3.0 インストールプロセスをチェーンできます。 .NET Framework 3.0 インストールプロセスをチェーンするには、コマンドラインから再頒布可能パッケージを実行し、次のサイレントインストールコマンドラインオプションを使用します。

/q /norestart

Web アプリケーション.NET Framework 3.0 の再配布

.NET Framework 3.0 の機能に依存する Web ベースのアプリケーションでは、.NET Frameworkをユーザーのコンピューターにダウンロードしてインストールする必要がある場合があります。ブラウザーヘッダーでユーザーエージェント文字列に対してクエリを実行することで、.NET Framework 3.0 がユーザーのコンピューターにインストールされているかどうかを確認できます。正しいバージョンの.NET Frameworkがインストールされていない場合は、.NET Framework 3.0 ダウンロードセンターにユーザーを誘導して、.NET Framework 3.0 パッケージを取得できます。

Microsoft .NET Framework 3.0 の検出

レジストリキーを読み取り、インターネットエクスプローラーでユーザーエージェント文字列に対してクエリを実行することで、.NET Framework 3.0 がインストールされているかどうかを検出できます。

レジストリキーの読み取り

インストールが成功すると、.NET Framework 3.0 インストーラーによってレジストリキーが書き込まれます。フレームワーク 3.0 がインストール whether.NET テストするには、次の表に示すレジストリキーを確認します。

レジストリキー名値

レジストリキー名	値
`HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v3.0\Setup`	名前: `InstallSuccess` 種類:DWORD データ: `1`
`HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Internet Settings\5.0\User Agent\Post Platform`	名前: `Version` 種類: REG_SZ データ: `.NET CLR 3.0.build number`

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v3.0\Setup

名前: InstallSuccess

種類:DWORD

データ: 1

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Internet Settings\5.0\User Agent\Post Platform

名前: Version

種類: REG_SZ

データ: .NET CLR 3.0.build number

インターネットエクスプローラーでのユーザーエージェント文字列の読み取り

.NET Framework 3.0 がコンピューターにインストールされている場合、ブラウザーヘッダーで報告されるユーザーエージェント文字列の一部として、.NET Framework 3.0 のバージョン番号が表示されます。次の例は、JavaScript を使用して Framework 3.0 がインストール whether.NET 検出して報告するサンプルページを示しています。

メモこのサンプルページにはインターネットエクスプローラーが必要です。

<HTML>
  <HEAD>
    <TITLE>Test for .NET Framework 3.0</TITLE>
    <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=utf-8" />
    <SCRIPT LANGUAGE="JavaScript">
    <!--
    var NETFX3RuntimeVersion = "3.0.50727";
    
    function window::onload()
    {
      if (HasRuntimeVersion(NETFX3RuntimeVersion))
      {
result.innerText = "This machine has the correct version of the .NET 
Framework 3.0 runtime: " + NETFX3RuntimeVersion + "."  + "\n\nThis 
machine's userAgent string is: " + navigator.userAgent + ".";
      } 
      else
      {
        document.write("The .NET Framework version 3.0 is not installed on this computer.<br/>"
+ "<a href='https://msdn.microsoft.com/windowsvista/default.aspx'>"
+ "Click here to get</a> .NET Framework 3.0 now.");      }
    }
    
    //
    // Retrieve the version from the user agent string and compare with specified version.
    //
    function HasRuntimeVersion(versionToCheck)
    {
      var userAgentString = navigator.userAgent.match(/.NET Framework 3.0 RunTime [0-9.]+/g);

      if (userAgentString != null)
      {
        var i;

        for (i = 0; i < userAgentString.length; ++i)
        {
          if (CompareVersions(GetVersion(versionToCheck), GetVersion(userAgentString[i])) <= 0)
            return true;
        }
      }

      return false;
    }

    //
    // Extract the numeric part of the version string.
    //
    function GetVersion(versionString)
    {
      var numericString = versionString.match(/([0-9]+)\.([0-9]+)\.([0-9]+)/i);
      return numericString.slice(1);
    }

    //
    // Compare the version strings by converting them to numeric format.
    //
    function CompareVersions(version1, version2)
    {
      for (i = 0; i < version1.length; ++i)
      {
        var number1 = new Number(version1[i]);
        var number2 = new Number(version2[i]);

        if (number1 < number2)
          return -1;

        if (number1 > number2)
          return 1;
      }

      return 0;
    }
    
    -->
    </SCRIPT>
  </HEAD>
  
  <BODY>
    <div id="result" />
  </BODY>
</HTML>

文字列 ".NET Framework 3.0" バージョンの検索が成功すると、次のメッセージが表示されます。

This machine has the correct version of the .NET Framework 3.0: 3.0.50727.
This machine's userAgent string is: Mozilla/4.0 (compatible; MSIE 6.0; 
Windows NT 5.1; SV1; .NET CLR 1.1.4322; .NET CLR 2.0.50727; .NET CLR 
3.0.50727).

それ以外の場合は、次のメッセージが表示されます。

The .NET Framework version 3.0 is not installed on this computer.
Click here to get the .NET Framework 3.0 now.

.NET Framework 3.0 再頒布可能パッケージのコマンドラインオプション

次の表に、コマンドラインから .NET Framework 3.0 再頒布可能パッケージインストールプログラム (Dotnetfx3.exe、Dotnetfx3_x64.exe、またはDotnet3setup.exe) を実行するときに含めることができるオプションを示します。

オプション	説明
`/q`	すべての UI を抑制します。このオプションでは、.INI ファイルを指定できません。
`/quiet`	`/q` と同じ。
`/qb`	最小限の UI が表示され、進行状況のみが表示されます。
`/passive`	`/qb` と同じ。
`/uninstall`	製品をアンインストールします。
`/remove`	`/uninstall` と同じ。
`/f`	インストールされているすべての.NET Framework 3.0 コンポーネントを修復します。
`/nopatch`	パッチが適用されないことを指定し、パッチチェックをバイパスします。
`/norollback`	セットアップコンポーネントが失敗した場合にセットアップがロールバックされないことを指定します。
`/norestart`	インストールの完了後にインストーラーがコンピューターを再起動しないことを指定します。再頒布可能パッケージインストーラーは、再起動が必要な場合ERROR_SUCCESS_REBOOT_REQUIRED (3010) を返します。
`/?`	このオプションの一覧を表示します。

.NET Framework 3.0 再頒布可能パッケージのエラーコード

次の表は、.NET Framework 3.0 再頒布可能パッケージインストールプログラム (Dotnetfx3.exe、Dotnetfx3_x64.exe、またはDotnet3setup.exe) によって返されるエラーコードの一覧です。エラーコードは、インストーラーのすべてのバージョンで同じです。

エラーコード	値	説明
`ERROR_SUCCESS`	0	アクションが正常に完了しました。
`ERROR_INSTALL_USEREXIT`	1602	ユーザーがインストールを取り消しました。
`ERROR_INSTALL_FAILURE`	1603	インストール中に致命的なエラーが発生しました。
`ERROR_UNKNOWN_PRODUCT`	1605	このアクションは、現在インストールされている製品に対してのみ有効です。
`ERROR_PATCH_PACKAGE_INVALID`	1636	パッチパッケージを開けなかったか、パッチが .NET Framework 3.0 に適用されませんでした。
`ERROR_INVALID_COMMAND_LINE`	1639	コマンドラインの引数が無効です。
`ERROR_SUCCESS_REBOOT_INITIATED`	1641	インストーラーが再起動を開始しました。これは成功を示し、セットアップは再起動後も続行されます。 (オプションが指定されている場合、 `/norestart` 再起動は実行されません)。
`ERROR_PATCH_PACKAGE_REJECTED`	1643	修正プログラムパッケージはシステムポリシーによって許可されていません。
`ERROR_SUCCESS_REBOOT_REQUIRED`	3010	インストールを完了するには再起動する必要があります。このメッセージが表示された場合、操作は成功しました。