The Microsoft®.NET Framework 3.0 provides a redistributable installer that contains .NET Framework 2.0 bindings that are required for Windows Vista™ APIs to run .NET Framework 3.0 applications.
The .NET Framework 3.0 redistributable package is available as a stand-alone executable file. The name of the file depends on the type of the targeted platform. For 32-bit platforms, the file is named Dotnetfx3.exe. For 64-bit platforms, the file is named Dotnetfx3_x64.exe. You can also deploy a small redistributable package named Dotnet3setup.exe that downloads the required components during setup.
Note: |
---|
IA64 support in the .NET Framework 3.0 is limited to Windows Vista. Windows Vista already includes the .NET Framework 3.0, so no redistributable package is necessary. |
You can manually launch and install the redistributable package on a computer, or it can be launched and installed as part of the setup program for a .NET Framework 3.0 application.
Note: |
---|
Administrator privileges are required to install the .NET Framework 3.0. |
This topic contains the following sections:
Installation Requirements
This section describes the software and hardware requirements for a computer where the Microsoft .NET Framework 3.0 redistributable package is to be installed. If the minimum requirements are not met, Dotnetfx3.exe will block the installation of the redistributable package.
Software Requirements
To install the .NET Framework 3.0, one of the following operating systems must be installed on the target computer:
-
Microsoft Windows XP Home or Microsoft Windows XP Professional, both with Service Pack 2 or later.
-
Microsoft Windows Server 2003 family with Service Pack 1 or later.
In Windows Vista and Windows Server code-named "Longhorn," the .NET Framework 3.0 is a feature of the operating system.
Hardware Requirements
The following table lists the hardware requirements for running the .NET Framework 3.0.
|
CPU Required |
RAM required |
Minimum |
Pentium 400 MHz |
96 MB |
Recommended |
Pentium 1 GHz or higher |
256 MB or more |
Where to Obtain the.NET Framework 3.0 Redistributable Package
You can download the Microsoft .NET Framework 3.0 redistributable package from the Microsoft Vista Download Center or from the Microsoft Windows Update Web site.
Note: |
---|
The Microsoft Windows Update site offers only the officially released version of the .NET Framework 3.0; it does not offer beta versions. |
If you need to have users install the Microsoft .NET Framework 3.0 from the Internet, do not post the redistributable package on your own network. Instead, direct users to the Microsoft Vista Download Center or the Microsoft Windows Update Web site.
Redistributing the .NET Framework 3.0 Using a Visual Studio 2005 Setup Project
When you deploy applications that are created with Visual Studio 2005 and that require the .NET Framework 3.0, the .NET Framework must be installed on the target computer before your application is installed. You can include the .NET Framework 3.0 in a setup executable file that you create using a Visual Studio 2005 setup project. If that is not practical, you can have users install the .NET Framework manually, as described later.
When you configure a Visual Studio 2005 setup project to install the .NET Framework 3.0 with your application, the .NET Framework 3.0 is packaged with your application. A launch condition in your application's setup checks whether the .NET Framework 3.0 is installed, and if necessary, the setup process installs the .NET Framework before installing your application. The .NET Framework 3.0 in turn checks whether the .NET Framework 2.0 is installed. If not, the setup process prompts the user to install the earlier version of the .NET Framework as well.
To include the .NET Framework 3.0 with your application's setup process, the optional Visual Studio Code Name "Orcas" Community Technology Preview - Development Tools for .NET Framework 3.0 must be installed on the computer where you create the setup project.
To determine if Visual Studio Code Name "Orcas" Development Tools for .NET Framework 3.0 are installed
-
In the Windows Control Panel, click Add or Remove Programs.
-
In the Add or Remove Programs dialog box, examine the Currently installed programs list for Microsoft Visual Studio Code Name "Orcas" Community Technology Preview - Development Tools for .NET Framework 3.0.
If Microsoft Visual Studio Code Name "Orcas" Community Technology Preview - Development Tools for .NET Framework 3.0 is not listed, you can download and install it from the Visual Studio Code Name Orcas page on the Microsoft Download Center.
When you are sure you have the development tools installed on your computer, you can create a setup project that includes the .NET Framework 3.0.
To include the .NET Framework 3.0 with a setup project
-
In Visual Studio 2005, create a new setup project following these steps:
-
In the File menu, click New, and then click Project.
-
Under Other Project Types, select Setup and Deployment.
-
Name your project and click OK.
-
-
Add your project output, merge modules, file, and assemblies.
-
In Solution Explorer, right-click the project name and then click Properties.
The Property Pages dialog box is displayed.
-
Click Prerequisites.
-
Select the Create setup program to install prerequisite components check box.
-
In the list, locate .NET Framework 3.0 and then select the version appropriate for the target platforms.
-
Specify the source location for the prerequisites.
For the location of the .NET Framework 3.0, you can specify either the Windows Vista Download site or a site of your own. The URL can also specify a CD on which your own application is being distributed.
-
Click OK.
Having Users Install the .NET Framework Manually
In some situations, it might be impractical for you to automatically install the .NET Framework 3.0 with your application. In that case, you can have users install the .NET Framework themselves. The redistributable package is available from several sources as noted earlier in the section . However, you should not assume that users of your application know where to get it or how to install it. In your setup process, provide instructions for how users should locate and install the .NET Framework.
Chaining the Redistributable Package in your Application Setup
If you do not want to create a Visual Studio setup project or have users install the .NET Framework 3.0 manually, you can chain the .NET Framework 3.0 installation process as part of your own application setup. To chain the .NET Framework 3.0 installation process, you can run the redistributable package from the command line and use the following silent installation command-line option:
/q /norestart
Redistributing the .NET Framework 3.0 for Web Applications
In Web-based applications that rely on .NET Framework 3.0 features, the .NET Framework might need to be downloaded and installed on the user's computer. You can determine whether the .NET Framework 3.0 is installed on the user's computer by querying the user-agent string in the browser header. If the correct version of the .NET Framework is not installed, you can direct users to the .NET Framework 3.0 Download Center to obtain the .NET Framework 3.0 package.
Detecting the Microsoft .NET Framework 3.0
You can detect if the .NET Framework 3.0 is installed by reading a registry key and by querying the user-agent string in Internet Explorer.
Reading Registry Keys
The .NET Framework 3.0 installer writes registry keys when installation is successful. You can test whether the .NET Framework 3.0 is installed by checking the registry keys listed in the following table.
Registry Key Name | Value |
---|---|
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v3.0\Setup |
Name: InstallSuccess Type: DWORD Data: 1 |
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Internet Settings\5.0\User Agent\Post Platform |
Name: Version Type: REG_SZ Data: .NET CLR 3.0.build number |
Reading the User-agent String in Internet Explorer
When the .NET Framework 3.0 is installed on a computer, the .NET Framework 3.0 version number appears as part of the user-agent string reported in browser headers. The following example shows a sample page that uses javascript to detect and report whether the .NET Framework 3.0 is installed.
Note: |
---|
This sample page requires Internet Explorer. |