Guía de implementación de .NET Framework 3.5 para desarrolladores de aplicaciones

Microsoft .NET Framework versión 3.5 proporciona un instalador redistribuible que también contiene Service Packs y actualizaciones acumulativas para .NET Framework 2.0 y 3.0.

En este tema se explica cómo redistribuir .NET Framework con las aplicaciones. Contiene las siguientes secciones:

• Formatos disponibles

• Dónde obtener el paquete redistribuible de .NET Framework 3.5

• Requisitos de instalación

• Instalar .NET Framework manualmente

• Encadenar el paquete redistribuible en la instalación de la aplicación

• Instalar .NET Framework 3.5 para aplicaciones web

• Detectar .NET Framework 3.5

• Opciones de la línea de comandos

• Códigos de error

• Apéndice: Componentes de .NET Framework 3.5

• Apéndice: Ejemplos de instalación

Formatos disponibles

El paquete redistribuible de .NET Framework 3.5 está disponible en dos formatos:

• dotnetfx35.exe Es un archivo ejecutable independiente que contiene todos los componentes necesarios para llevar a cabo la implementación en las plataformas de 32 bits y 64 bits en todos los sistemas operativos compatibles. Este archivo ejecutable no contiene paquetes de idioma; de manera predeterminada, descarga e instala el paquete de idioma que coincide con el idioma del sistema operativo del usuario. Los paquetes de idioma de .NET Framework versión 3.5 están disponibles como archivos ejecutables independientes separados por idioma en el Centro de descarga de Microsoft.

• dotnetfx35setup.exe Es un arranque ligero que descarga los componentes necesarios de la Web durante la instalación. Este archivo ejecutable no contiene componentes de la versión 3.5 de .NET Framework; detecta, descarga e instala únicamente los componentes necesarios de la Web. El arranque también descarga e instala el paquete de idioma que coincide con el idioma del sistema operativo del usuario. Se pueden usar paquetes de idioma independientes para instalar la compatibilidad con otros idiomas.

Puede utilizar el paquete de la plataforma de 32 bits y de la plataforma de 64 bits en todos los sistemas operativos admitidos.

Puede ejecutar e instalar manualmente el paquete redistribuible en un equipo, o bien ejecutarlo e instalarlo como parte del programa de instalación de una aplicación .NET Framework 3.5.

Nota:
Se necesitan privilegios de administrador para poder instalar .NET Framework 3.5.

Dónde obtener el paquete redistribuible de .NET Framework 3.5

Puede descargar el paquete redistribuible de Microsoft .NET Framework 3.5 desde el Centro de descarga de Microsoft. El botón Descargar situado en la parte superior de la página instala el arranque (dotNetFx35setup.exe). Para descargar el paquete de instalación completo, desplácese al vínculo Paquete redistribuible completo, que se encuentra en la parte inferior de la página.

Requisitos de instalación

En esta sección se resumen los requisitos de software y hardware para instalar .NET Framework 3.5. Si no se cumplen los requisitos mínimos, el proceso de instalación de .NET Framework detiene la instalación.

Para obtener una lista detallada de los requisitos de hardware y software, vea Requisitos del sistema para la versión 3.5.

Requisitos de software

.NET Framework 3.5 requiere que esté instalado uno de los sistemas operativos siguientes en el equipo de destino:

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

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

• Windows Vista.

• Windows Server 2008.

  Nota:
  .NET Framework 3.5 solo admite IA64 en Microsoft Windows Server 2008.

Requisitos de hardware

En la tabla siguiente se enumeran los requisitos de CPU y RAM para ejecutar .NET Framework 3.5.

Instalar .NET Framework manualmente

En algunas situaciones, quizás no resulte práctico instalar automáticamente .NET Framework 3.5 con la aplicación. En ese caso, puede pedir a los usuarios que instalen .NET Framework desde el Centro de descarga de Microsoft. En el proceso de instalación, proporcióneles instrucciones para que puedan localizar e instalar .NET Framework.

Nota:
No publique el paquete redistribuible en su propia red. En su lugar, dirija a los usuarios al Centro de descarga de Microsoft.

Encadenar el paquete redistribuible en la instalación de la aplicación

.NET Framework 3.5 proporciona tres maneras de incluir ("encadenar") el proceso de instalación de .NET Framework en el proceso de instalación de la aplicación:

• Opción 1. Permitir que el proceso de instalación de .NET Framework decida qué componentes son necesarios y descargue e instale únicamente los componentes necesarios de la Web.

  Para permitir que el proceso de instalación de .NET Framework detecte, descargue e instale únicamente los componentes necesarios, utilice el paquete dotnetfx35setup.exe. Para encadenar el proceso de instalación de .NET Framework, agregue el comando siguiente al proceso de instalación de la aplicación:

  dotnetfx35setup.exe /q /norestart

• Opción 2. Incluir el conjunto completo de archivos .NET Framework en los discos de redistribución para que los usuarios no tengan que descargar ningún archivo adicional de la Web durante la instalación.

  Si desea incluir todos los componentes en el proceso de instalación de .NET Framework, use el archivo ejecutable independiente completo (dotnetfx35.exe). Este paquete contiene componentes que son necesarios para instalar .NET Framework 3.5 en equipos x86, x64 e IA64 con cualquier sistema operativo compatible. Utilice este paquete si el espacio y el tiempo de descarga no supone un problema para la implementación de la aplicación. Para encadenar el proceso de instalación de .NET Framework, use el comando siguiente:

  dotnetfx35.exe /q /norestart

• Opción 3. Incluir los componentes que suelen ser más necesarios para los usuarios y permitir que el proceso de instalación de .NET Framework detecte los componentes que faltan y los descargue de la Web. Este escenario es el óptimo si se pretende implementar la aplicación en una plataforma, sistema operativo o configuración de sistema de usuario específicos.

  Para realizar esta instalación, en primer lugar debe obtener el archivo ejecutable independiente completo y extraer los archivos con el comando siguiente:

  dotnetfx35.exe /x extract-location

  Después de extraer los archivos, verá una estructura de archivos y carpetas con la lista de archivos de cada componente de .NET Framework 3.5, tal y como se muestra en el Apéndice de este documento.

  Para implementar .NET Framework 3.5, incluya los componentes adecuados en la estructura de carpetas que se crea en el proceso de extracción y encadénelos en el programa de arranque de .NET Framework con el comando siguiente:

  dotnetfx35setup.exe /q /norestart

  En el Apéndice de este documento, se pueden ver dos ejemplos de lo que se puede incluir en el diseño.

Independientemente del modo que elija, para encadenar el proceso de instalación de .NET Framework 3.5, ejecute el archivo redistribuible desde la línea de comandos y utilice las opciones de línea de comandos /q y /norestart.

Nota:
Para evitar la descarga e instalación automáticas de los paquetes de idioma, use la opción de línea de comandos /lang:enu.

Instalar .NET Framework 3.5 para aplicaciones web

Las aplicaciones basadas en Web que utilicen características de .NET Framework 3.5 pueden requerir que .NET Framework se descargue e instale en el equipo del usuario. Para determinar si .NET Framework 3.5 se encuentra instalado en el equipo del usuario, puede realizar el procedimiento de la sección siguiente. Si no está instalada la versión correcta de .NET Framework, puede remitir a los usuarios al Centro de descarga de Microsoft para obtener el paquete de .NET Framework 3.5.

Detectar .NET Framework 3.5

Para detectar si .NET Framework 3.5 ya está instalado, puede leer una clave del Registro o consultar la cadena de agente de usuario en Internet Explorer.

Leer claves del Registro

El instalador de .NET Framework 3.5 escribe las claves del Registro cuando la instalación finaliza correctamente. Para confirmar si .NET Framework 3.5 está instalado, puede comprobar las claves del Registro que se muestran en la tabla siguiente.

Leer la cadena de agente de usuario en un explorador

Cuando .NET Framework 3.5 se instala en un equipo, el número de versión de .NET Framework 3.5 aparece como parte de la cadena de agente de usuario que se notifica en los encabezados del explorador. En el ejemplo siguiente se muestra una página de ejemplo en la que se utiliza JavaScript para detectar y notificar si .NET Framework 3.5 está instalado.

<html>
  <head>
    <title>Test for .NET Framework 3.5</title>
    <meta HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=utf-8" />
    <script type="text/JavaScript">
    <!--
    var NETFX3RuntimeVersion = "3.5.21022";
    
    function body_onload()
    {
      var result = document.getElementById("result");
      if (HasRuntimeVersion(NETFX3RuntimeVersion))
      {
          result.innerHTML = "This machine has the correct version of the .NET Framework 3.5 runtime: " 
          + NETFX3RuntimeVersion + "." 
          + "\n\nThis machine's userAgent string is: " 
          + navigator.userAgent + ".";
      } 
      else
      {
        result.innerHTML = "The .NET Framework version 3.5 is not installed on this computer.<br/>"
            + "Click <a href='https://go.microsoft.com/fwlink/?LinkId=96339'"
            + " here</a> to get the .NET Framework 3.5 now.";}
    }
    
    //
    // Retrieve the version from the user agent string and compare with specified version.
    //
    function HasRuntimeVersion(versionToCheck)
    {
      var userAgentString = 
           navigator.userAgent.match(/.NET CLR 3.5.[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 onload="body_onload();">
    <div id="result" ></div>
  </body>
</html>

Si la búsqueda de la cadena de la versión ".NET Framework 3.5" da resultado, se muestra el siguiente mensaje:

This machine has the correct version of the .NET Framework 3.5 runtime: 3.5.28015.00.
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.5.28015.00).

(Los detalles de la cadena de agente de usuario varían ligeramente según el explorador y la versión del explorador que se utilizan para comprobar .NET Framework).

Si .NET Framework 3.5 no está instalado, se muestra el mensaje siguiente:

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

Opciones de la línea de comandos

En la tabla siguiente se enumeran las opciones que se pueden especificar al ejecutar el instalador redistribuible de .NET Framework 3.5 desde la línea de comandos.

Códigos de error

En la tabla siguiente se muestran los códigos de error que puede devolver el programa de instalación redistribuible de .NET Framework 3.5. Los códigos de error son los mismos para todas las versiones del instalador.

Apéndice

En las tablas que se ofrecen en este apéndice, los sistemas operativos se han abreviado de la siguiente manera:

• XP = Windows XP

• Vista = Windows Vista

• W2K3 = Windows Server 2003

• W2K8 = Windows Server 2008

Componentes de NET Framework 3.5

En la tabla siguiente se muestran los componentes de .NET Framework versión 3.5.

Ejemplos de instalación

En los ejemplos siguientes se muestran los archivos que debe incluir en los medios de instalación para dos escenarios de instalación diferentes.

Nota:
Cuando incluya cada uno de los componentes, debe hacerlo en la misma ruta de acceso relativa que la del arranque de instalación de .NET Framework 3.5 (dotNetFx35setup.exe).

Ejemplo 1

En la tabla siguiente se muestran los archivos que debe incluir en el diseño de los medios de instalación si va a realizar la implementación en Windows XP o Windows Vista. En la lista de archivos, se da por hecho que los usuarios solo instalan la versión x86 y que ya han instalado .NET Framework 2.0 SP1 y 3.0 SP1 (en Windows XP y Windows Server 2003) o la actualización acumulativa (en Windows Vista).

Ejemplo 2

En la tabla siguiente se muestran los archivos que debe incluir en el diseño de los medios de instalación si va a realizar la implementación en Windows XP SP2 o Windows Server 2003 SP1 en equipos x86 y x64. En la lista de archivos se da por hecho que los usuarios ya tienen instalado .NET Framework 2.0 SP1.

Nota:
En este ejemplo, si el usuario no tiene .NET Framework 2.0 SP1, el programa de instalación lo descargará automáticamente si está conectado a Internet.

Vea también

Conceptos

Guía de implementación de .NET Framework 3.5 para administradores