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

  • Artículo

 

Microsoft Corporation

Julio de 2006

Contenido

Resumen
Introducción
Requisitos de instalación
   Requisitos de software
   Requisitos de hardware
Dónde obtener el paquete redistribuible de .NET Framework 3.0
Redistribuir .NET Framework 3.0 mediante un proyecto de instalación de Visual Studio 2005
Hacer que los usuarios instalen .NET Framework manualmente
Encadenar el paquete redistribuible en la configuración de la aplicación
Redistribuir .NET Framework 3.0 para aplicaciones web
Detección de Microsoft .NET Framework 3.0
   Lectura de claves del Registro
   Lectura de la cadena de agente de usuario en Internet Explorer
Opciones de línea de comandos para .NET Framework 3.0 Redistributable
Códigos de error para .NET Framework 3.0 Redistributable

Resumen

En este artículo se describe cómo implementar aplicaciones de Microsoft .NET Framework 3.0 con Dotnetfx3.exe, el paquete redistribuible de .NET Framework 3.0. (10 páginas impresas)

Nota Esta documentación puede incluir información para escenarios que tratan la distribución, pero la documentación no le concede derechos para usar ni distribuir ninguna parte de los componentes. El uso de los componentes está sujeto al contrato de licencia para los componentes. Revise el contrato de licencia componentes para comprender sus derechos y las condiciones de uso.

Introducción

El Microsoft.NET Framework 3.0 proporciona un instalador redistribuible que contiene enlaces de .NET Framework 2.0 a las API de Windows Vista necesarias para ejecutar 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 la plataforma de destino. En el caso de las plataformas de 32 bits, el archivo se denomina Dotnetfx3.exe. En el caso de las plataformas de 64 bits, el archivo se denomina Dotnetfx3_x64.exe. También puede implementar un pequeño paquete redistribuible denominado Dotnet3setup.exe que descargue los componentes necesarios durante la instalación.

Nota La compatibilidad con IA64 en .NET Framework 3.0 se limita al código de Microsoft Windows Server denominado "Longhorn". Longhorn ya incluye .NET Framework 3.0, por lo que no es necesario ningún paquete redistribuible.

Puede iniciar e instalar manualmente el redistribuible en un equipo, o bien se puede iniciar e instalar como parte del programa de instalación de una aplicación de .NET Framework 3.0.

Nota Se requieren privilegios de administrador para instalar .NET Framework 3.0.

Requisitos de instalación

En esta sección se describen los requisitos de software y hardware de un equipo en el que se va a instalar el paquete redistribuible de Microsoft .NET Framework 3.0. Si no se cumplen los requisitos mínimos, Dotnetfx3.exe bloqueará la instalación del paquete redistribuible.

Requisitos de software

Para instalar Microsoft .NET Framework 3.0, se debe instalar uno de los siguientes sistemas operativos en el equipo de destino:

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

Para Microsoft Windows Vista (sin incluir la plataforma IA64) y el código de Microsoft Windows Server denominado "Longhorn" IA64 Edition, .NET Framework 3.0 es una característica del sistema operativo.

Requisitos de hardware

En la tabla siguiente se enumeran los requisitos de hardware para ejecutar .NET Framework 3.0.

  CPU necesaria Ram requerida
Mínima Pentium 400 MHz 96 MB
Recomendado Pentium 1 GHz o superior 256 MB o más

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

Puede descargar el paquete redistribuible de Microsoft .NET Framework 3.0 desde el Centro de descarga de Microsoft Vista o desde el sitio web de Microsoft Windows Update.

Nota El sitio de Microsoft Windows Update ofrece solo la versión publicada oficialmente de .NET Framework 3.0; no ofrece versiones beta.

Si necesita que los usuarios instalen Microsoft .NET Framework 3.0 desde Internet, no publique el paquete redistribuible en su propia red. En su lugar, dirija a los usuarios al Centro de descarga de Microsoft Vista o al sitio web de Microsoft Windows Update.

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

Al implementar aplicaciones creadas con Visual Studio 2005 y que requieren .NET Framework 3.0, .NET Framework debe instalarse en el equipo de destino antes de instalar la aplicación. Puede incluir .NET Framework 3.0 en un archivo ejecutable de instalación que cree mediante un proyecto de instalación de Visual Studio 2005. Si esto no es práctico, puede hacer que los usuarios instalen .NET Framework manualmente, como se describe más adelante.

Al configurar un proyecto de instalación de Visual Studio 2005 para instalar Microsoft .NET Framework 3.0 con la aplicación, .NET Framework 3.0 se empaqueta con la aplicación. Una condición de inicio en la configuración de la aplicación comprueba whether.NET Framework 3.0 está instalado y, si es necesario, el proceso de instalación instala .NET Framework antes de instalar la aplicación. A su vez, Microsoft .NET Framework 3.0 comprueba whether.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 con el proceso de instalación de la aplicación, las extensiones opcionales de Visual Studio para .NET Framework 3.0 deben instalarse en el equipo donde se crea el proyecto de instalación.

Para determinar si están instaladas las extensiones de Visual Studio para .NET Framework 3.0

  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 , examine la lista Programas instalados actualmente para Extensiones de Microsoft Visual Studio 2005 para .NET Framework 3.0.

Si visual Studio 2005 Extensions for .NET Framework 3.0 no aparece en la lista, puede descargar e instalar el paquete de extensiones como parte de las Herramientas de desarrollo para WinFX, disponible en la página Microsoft Visual Studio Code Nombre "Orcas" Community Technology Preview – Development Tools for WinFX en el Centro de descarga de Microsoft.

Cuando esté seguro de que tiene instalado el paquete Extensiones de Visual Studio para .NET Framework 3.0 en el equipo, puede crear un proyecto de instalación que incluya .NET Framework 3.0.

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

  1. En Visual Studio 2005, cree un nuevo proyecto de instalación siguiendo estos pasos:

    1. En el menú Archivo , haga clic en Nuevoy, a continuación, haga clic en Proyecto.
    2. En Otros tipos de proyecto, seleccione Configuración e implementación.
    3. Asigne un nombre al proyecto y haga clic en Aceptar.

  2. Agregue la salida del proyecto, los módulos de combinación, el archivo y los ensamblados.

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

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

  4. Haga clic en Requisitos previos.

  5. Active la casilla Crear programa de instalación para instalar componentes de requisitos previos .

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

  7. Especifique la ubicación de origen para los requisitos previos.

    Para la ubicación de .NET Framework 3.0, puede especificar el sitio de descarga de Windows Vista o un sitio propio. La dirección URL también puede especificar un CD en el que se distribuye su propia aplicación.

  8. Haga clic en Aceptar.

Hacer que los usuarios instalen .NET Framework manualmente

En algunas situaciones, es posible que no sea práctico instalar automáticamente .NET Framework 3.0 con la aplicación. En esos casos, puede dejar que los usuarios instalen .NET Framework por su cuenta. El redistribuible está disponible en varios orígenes, como se indicó anteriormente en la sección Dónde obtener the.NET Framework 3.0 Redistributable Package. Sin embargo, no debe suponer que los usuarios de la aplicación saben dónde obtenerla o cómo instalarla. En el proceso de instalación, ofrezca instrucciones a los usuarios para que localicen e instalen .NET Framework.

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

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

/q /norestart

Redistribuir .NET Framework 3.0 para aplicaciones web

En las aplicaciones basadas en web que se basan en las características de .NET Framework 3.0, es posible que sea necesario descargar e instalar .NET Framework en el equipo del usuario. Puede determinar si .NET Framework 3.0 está instalado en el equipo del usuario consultando la cadena user-agent en el encabezado del explorador. Si la versión correcta de .NET Framework no está instalada, puede dirigir a los usuarios al Centro de descarga de .NET Framework 3.0 para obtener el paquete de .NET Framework 3.0.

Detección de Microsoft .NET Framework 3.0

Puede detectar si .NET Framework 3.0 está instalado leyendo una clave del Registro y consultando la cadena de agente de usuario en Internet Explorer.

Lectura de claves del Registro

El instalador de .NET Framework 3.0 escribe claves del Registro cuando la instalación se realiza correctamente. Puede probar whether.NET Framework 3.0 está instalado comprobando las claves del Registro enumeradas en la tabla siguiente.

Nombre de clave del Registro Value 
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v3.0\Setup
 Nombre: InstallSuccess

Tipo: DWORD

Data: 1

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

Tipo: REG_SZ

Data: .NET CLR 3.0.build number

Lectura de la cadena de agente de usuario en Internet Explorer

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

Nota Esta página de ejemplo 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='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>

Si la búsqueda de la versión ".NET Framework 3.0" es correcta, se muestra 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).

De lo contrario, aparece 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.

Opciones de línea de comandos para .NET Framework 3.0 Redistributable

En la tabla siguiente se enumeran las opciones que puede 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.

Opción Descripción 
/q
 Suprime toda la interfaz de usuario. No se puede especificar un archivo .INI con esta opción. 
/quiet
 Igual a /q. 
/qb
 Muestra la interfaz de usuario mínima, que muestra solo el progreso. 
/passive
 Igual a /qb. 
/uninstall
 Desinstala el producto. 
/remove
 Igual a /uninstall. 
/f
 Repara todos los componentes de .NET Framework 3.0 instalados. 
/nopatch
 Especifica que las revisiones no se aplican y omiten la comprobación de revisiones. 
/norollback
 Especifica que el programa de instalación no se revierte si se produce un error en un componente de instalación. 
/norestart
 Especifica que el instalador no reinicia el equipo una vez completada la instalación. El instalador redistribuible devuelve ERROR_SUCCESS_REBOOT_REQUIRED (3010) si se requiere un reinicio. 
/?
 Muestra esta lista de opciones.

Códigos de error para .NET Framework 3.0 Redistributable

En la tabla siguiente 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.

Código de error Value Descripción 
ERROR_SUCCESS
 0 La acción se ha realizado correctamente. 
ERROR_INSTALL_USEREXIT
 1602 Instalación cancelada por el usuario. 
ERROR_INSTALL_FAILURE
 1603 Error irrecuperable durante la instalación. 
ERROR_UNKNOWN_PRODUCT
 1605 Esta acción solo es válida para los productos que están instalados actualmente. 
ERROR_PATCH_PACKAGE_INVALID
 1636 No se pudo abrir el paquete de revisión o la revisión no se aplicaba a .NET Framework 3.0. 
ERROR_INVALID_COMMAND_LINE
 1639 Argumento de línea de comandos no válido. 
ERROR_SUCCESS_REBOOT_INITIATED
 1641 El instalador ha iniciado una operación de reinicio. Esto indica que se ha realizado correctamente y la configuración continuará después del reinicio. (El reinicio no se realiza si se especificó la /norestart opción). 
ERROR_PATCH_PACKAGE_REJECTED
 1643 La directiva del sistema no permite el paquete de revisión. 
ERROR_SUCCESS_REBOOT_REQUIRED
 3010 Para completar la instalación es necesario reiniciar. Este mensaje indica que la instalación se realizó correctamente.