Guía de implementación de Microsoft .NET Framework 3.0

2006

Microsoft®.NET Framework 3.0 ofrece un instalador redistribuible que contiene enlaces de .NET Framework 2.0, necesarios para que las API de Windows Vista™ ejecuten las aplicaciones de .NET Framework 3.0.

El paquete redistribuible de .NET Framework 3.0 está disponible como un archivo ejecutable independiente. El nombre del archivo depende del tipo de plataforma de destino. Para plataformas de 32 bits, el archivo se llama Dotnetfx3.exe. Para plataformas de 64 bits, el nombre del archivo es Dotnetfx3_x64.exe. Asimismo, se puede implementar un pequeño paquete redistribuible llamado Dotnet3setup.exe que descarga los componentes necesarios durante la instalación.

Nota

La compatibilidad con IA64 en .NET Framework 3.0 se limita a Windows Vista. Windows Vista ya incluye .NET Framework 3.0, de modo que no es necesario el paquete redistribuible.

El paquete redistribuible se puede ejecutar e instalar manualmente en el equipo; asimismo, estas tareas se pueden llevar a cabo como parte del programa de instalación de cualquier aplicación .NET Framework 3.0.

Nota

Se necesitan privilegios de administrador para instalar .NET Framework 3.0.

En esta página

 Requisitos de instalación
 Dónde obtener .NET Framework 3.0 Redistributable Package
 Redistribución de .NET Framework 3.0 mediante un proyecto de instalación de Visual Studio 2005
 Instalación manual de .NET Framework por parte del usuario
 Encadenamiento del paquete redistribuible en la aplicación de instalación
 Redistribución de .NET Framework 3.0 para aplicaciones Web
 Detección de .NET Framework 3.0
 Opciones de línea de comandos para el instalador redistribuible de .NET Framework 3.0
 Códigos de error del instalador redistribuible de .NET Framework 3.0

Requisitos de instalación

En esta sección se describen los requisitos de software y hardware para los equipos donde se desee instalar Microsoft .NET Framework 3.0 Redistributable Package. Si no se cumplen los requisitos mínimos, Dotnetfx3.exe bloqueará la instalación del paquete redistribuible.

Requisitos de software

Para instalar .NET Framework, el equipo de destino debe contar con uno de los siguientes sistemas operativos:

• Microsoft Windows XP Home o Microsoft Windows XP Professional, ambos con Service Pack 2 o posterior.

• Familia Microsoft Windows Server 2003 con Service Pack 1 o posterior.

En Windows Vista y Windows Server (nombre en código "Longhorn"), .NET Framework 3.0 es una característica del sistema operativo.

Requisitos de hardware

En la siguiente tabla se presenta una lista de requisitos de hardware para la ejecución de .NET Framework 3.0.

 Principio de la página

Dónde obtener .NET Framework 3.0 Redistributable Package

Microsoft .NET Framework 3.0 Redistributable Package se puede descargar en el Centro de descarga de Microsoft Vista o en el sitio Web Microsoft Windows Update.

Nota

El sitio Microsoft Windows Update ofrece sólo la versión de lanzamiento oficial de .NET Framework 3.0, no las versiones beta.

Si se necesita que los usuarios instalen Microsoft .NET Framework 3.0 desde Internet, no se debe enviar el paquete redistribuible en la red propia. En su lugar, se debe dirigir a los usuarios al Centro de descarga de Microsoft Vista o en el sitio Web Microsoft Windows Update.

 Principio de la página

Redistribución de .NET Framework 3.0 mediante un proyecto de instalación de Visual Studio 2005

Al implementar aplicaciones creadas con Visual Studio 2005 o que requieran .NET Framework 3.0, .NET Framework debe estar instalado en el equipo de destino antes de instalar la aplicación. Se puede incluir .NET Framework 3.0 en un archivo ejecutable de instalación creado con un proyecto de instalación de Visual Studio 2005. Si no resulta práctico, se puede solicitar a los usuarios que instalen manualmente .NET Framework, como se describirá más adelante.

Al configurar un proyecto de instalación de Visual Studio 2005 para instalar .NET Framework 3.0 junto con la aplicación, .NET Framework 3.0 se empaqueta con ella. Una condición de inicio de la instalación de la aplicación comprueba si .NET Framework 3.0 está instalado y, en caso necesario, el proceso de instalación instala .NET Framework antes que la aplicación. A su vez, .NET Framework 3.0 comprueba si .NET Framework 2.0 está instalado. Si no es así, el proceso de instalación solicita al usuario que instale también la versión anterior de .NET Framework.

Para incluir .NET Framework 3.0 en el proceso de instalación de la aplicación, el equipo donde se cree el proyecto de instalación debe disponer de las herramientas de desarrollo Microsoft Visual Studio Code Name "Orcas" Community Technology Preview - Development Tools para .NET Framework 3.0.

Para determinar si están instaladas las herramientas de desarrollo para .NET Framework 3.0 de Visual Studio Code Name "Orcas" Development Tools

1. En el Panel de control de Windows, haga clic en Agregar o quitar programas.

2. En el cuadro de diálogo Agregar o quitar programas, se debe examinar la lista Programas actualmente instalados en busca de Microsoft Visual Studio Code Name "Orcas" Community Technology Preview - Development Tools for .NET Framework 3.0.

Si Microsoft Visual Studio Code Name "Orcas" Community Technology Preview - Development Tools for .NET Framework 3.0 no se encuentra en la lista, se puede descargar e instalar desde la página Visual Studio Code Name Orcas del Centro de descargas de Microsoft.

Cuando esté seguro de haber instalado correctamente las herramientas de desarrollo en el equipo, puede crear un proyecto de instalación que incluya .NET Framework 3.0.

Para incluir .NET Framework 3.0 en un proyecto de instalación

1. En Visual Studio 2005, se crea un nuevo proyecto de instalación según los siguientes pasos:

   1. En el menú Archivo, haga clic en Nuevo y, a continuación, en Proyecto.

   2. En Otros tipos de proyecto, debe seleccionar Instalación e implementación.

   3. Dé un nombre al proyecto y haga clic en Aceptar.

2. Se agregan los resultados del proyecto, módulos de combinación, archivos y ensamblados.

3. En el Explorador de soluciones, haga clic con el botón secundario sobre el nombre del proyecto y, a continuación, en Propiedades.

   Aparece el cuadro de diálogo Páginas de propiedades.

4. Haga clic en Requisitos previos.

5. A continuación, seleccione la casilla de verificación Crear programa de instalación para instalar los componentes necesarios.

6. En la lista, localice .NET Framework 3.0 y seleccione la versión adecuada para las plataformas de destino.

7. Se ha de especificar la ubicación de origen de los requisitos previos.

   Para la ubicación de .NET Framework 3.0, se puede especificar el sitio de descarga de Windows Vista o un sitio propio. Asimismo, la URL puede especificar un CD de distribución de la aplicación.

8. Haga clic en Aceptar.

 Principio de la página

Instalación manual de .NET Framework por parte del usuario

En algunos casos, puede que la instalación automática de .NET Framework 3.0 en la aplicación no sea práctica. En tal caso, se puede solicitar a los usuarios que instalen ellos mismos .NET Framework. El paquete redistribuible está disponible en varias fuentes, como se indicó en la sección Dónde obtener Microsoft .NET Framework 3.0 Redistributable Package. No obstante, no se debe asumir que los usuarios de la aplicación saben dónde obtenerla o cómo instalarla. En el proceso de instalación, es aconsejable proporcionar instrucciones para que los usuarios ubiquen e instalen .NET Framework.

 Principio de la página

Encadenamiento del paquete redistribuible en la aplicación de instalación

Si no desea crear un proyecto de instalación de Visual Studio o hacer que los usuarios instalen manualmente .NET Framework 3.0, puede encadenar el proceso de instalación de .NET Framework 3.0 como parte de la instalación de la aplicación propia. Para encadenar el proceso de instalación de .NET Framework 3.0, puede ejecutar el paquete redistribuible desde la línea de comandos y usar la siguiente opción de línea de comandos de instalación silenciosa:

Copiar código

/q /norestart

 Principio de la página

Redistribución de .NET Framework 3.0 para aplicaciones Web

En las aplicaciones basadas en la Web que dependen de características de .NET Framework, puede que éste se deba descargar e instalar en el equipo del usuario. Se puede determinar si .NET Framework 3.0 está instalado en el equipo del usuario mediante una consulta a la cadena del agente de usuario del encabezado del explorador. Si la versión correcta de .NET Framework no está instalada, puede dirigir a los usuarios al Centro de descargas de .NET Framework para que obtengan el paquete .NET Framework 3.0.

 Principio de la página

Detección de .NET Framework 3.0

Se puede detectar si .NET Framework 3.0 está instalado mediante la lectura de la clave de registro y la consulta a la cadena del agente de usuario de Internet Explorer.

Lectura de claves de registro

El instalador de .NET Framework 3.0 escribe unas claves de registro cuando la instalación es correcta. Se puede verificar que .NET Framework está instalado comprobando las claves de registro de la siguiente tabla.

Lectura de la cadena del Agente de usuario en Internet Explorer

Cuando .NET Framework 3.0 está instalado en un equipo, su número de versión aparece como parte de la cadena del agente de usuario que se muestra en los encabezados del explorador. En el siguiente ejemplo se puede observar una página de muestra que usa JavaScript para detectar e informar de si .NET Framework está instalado.

Nota

Esta página de muestra requiere Internet Explorer.

<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='http://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>

Si la búsqueda de la cadena ".NET Framework 3.0" concluye con éxito, se mostrará el siguiente mensaje:

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).

En caso contrario, aparecerá el siguiente mensaje:

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

 Principio de la página

Opciones de línea de comandos para el instalador redistribuible de .NET Framework 3.0

En la siguiente tabla se enumeran las opciones que se pueden incluir al ejecutar el programa de instalación redistribuible de .NET Framework 3.0 (Dotnetfx3.exe, Dotnetfx3_x64.exe, o Dotnet3setup.exe) desde la línea de comandos.

 Principio de la página

Códigos de error del instalador redistribuible de .NET Framework 3.0

En la siguiente tabla se enumeran los códigos de error que puede devolver el programa de instalación redistribuible de .NET Framework 3.0 (Dotnetfx3.exe, Dotnetfx3_x64.exe o Dotnet3setup.exe). Los códigos de error son los mismos para todas las versiones del instalador.

Principio de la página