Compartir vía

Cómo: Configurar una aplicación para admitir .NET Framework 4 o versiones posteriores

Todas las aplicaciones que hospedan el Common Language Runtime (CLR) deben iniciar o activar el CLR para ejecutar código administrado. Normalmente, una aplicación de .NET Framework se ejecuta en la versión de CLR en la que se creó, pero puede cambiar este comportamiento para las aplicaciones de escritorio mediante un archivo de configuración de aplicación (a veces denominado archivo de aplicación.config ). Sin embargo, no puedes cambiar el comportamiento de activación predeterminado para las aplicaciones de la Tienda Windows o las aplicaciones de Windows Phone mediante un archivo de configuración de la aplicación. En este artículo se explica cómo habilitar la aplicación de escritorio para que se ejecute en otra versión de .NET Framework y se proporciona un ejemplo de cómo establecer como destino la versión 4 o versiones posteriores.

La versión de .NET Framework en la que se ejecuta una aplicación se determina en el orden siguiente:

  • Archivo de configuración.

    Si el archivo de configuración de la aplicación incluye <entradas supportedRuntime> que especifican una o varias versiones de .NET Framework y una de esas versiones está presente en el equipo del usuario, la aplicación se ejecuta en esa versión. El archivo de configuración lee <las entradas supportedRuntime> en el orden en que aparecen y usa la primera versión de .NET Framework que aparece en el equipo del usuario. (Use el <requiredRuntime> elemento para la versión 1.0).

  • Versión compilada.

    Si no hay ningún archivo de configuración, pero la versión de .NET Framework en la que se creó la aplicación está presente en el equipo del usuario, la aplicación se ejecuta en esa versión.

  • Versión más reciente instalada.

    Si la versión de .NET Framework en la que se creó la aplicación no está presente y un archivo de configuración no especifica una versión en un <supportedRuntime> elemento, la aplicación intenta ejecutarse en la versión más reciente de .NET Framework que está presente en el equipo del usuario.

    Sin embargo, las aplicaciones de .NET Framework 1.0, 1.1, 2.0, 3.0 y 3.5 no se ejecutan automáticamente en .NET Framework 4 o posterior y, en algunos casos, es posible que el usuario reciba un error y se le pida que instale .NET Framework 3.5. El comportamiento de activación también puede depender del sistema operativo del usuario, ya que diferentes versiones del sistema Windows incluyen versiones diferentes de .NET Framework. Si la aplicación admite .NET Framework 3.5 y 4 o posterior, se recomienda indicarlo con varias entradas en el archivo de configuración para evitar errores de inicialización de .NET Framework. Para obtener más información, vea Versiones y dependencias.

También puede configurar las aplicaciones de .NET Framework 3.5 para que se ejecuten en .NET Framework 4 o versiones posteriores, incluso en equipos que tengan instalado .NET Framework 3.5, para aprovechar las mejoras de rendimiento en las versiones 4 y versiones posteriores.

Importante

Se recomienda probar siempre la aplicación en cada versión de .NET Framework que admita. Consulte Compatibilidad de versiones para obtener información sobre cómo actualizar la aplicación para admitir versiones posteriores de .NET Framework.

Para obtener información sobre cómo modificar las aplicaciones de .NET Framework 1.0 y 1.1 para admitir Windows 7 y Windows 8, consulte Migración desde .NET Framework 1.1.

Ejecución de la aplicación en .NET Framework 4.x

  1. Agregue o busque el archivo de configuración para el proyecto de .NET Framework.

    El archivo de configuración de una aplicación es un archivo XML que se encuentra en el mismo directorio y tiene el mismo nombre de archivo que la aplicación, pero con una .config extensión. Por ejemplo, para una aplicación denominada MyExecutable.exe, el archivo de configuración de la aplicación se denomina MyExecutable.exe.config.

    Para agregar un archivo de configuración en Visual Studio, busque la barra de menús y seleccione ProjectAdd New Item (Agregar nuevo elemento> Elija General en el panel izquierdo y, a continuación, seleccione Archivo de configuración. Asigne al archivo de configuración el nombre App.config. Estas opciones de menú no están disponibles para las aplicaciones de la Tienda Windows porque no puedes cambiar la directiva de activación en esa plataforma.

  2. Agregue el elemento <supportedRuntime> de la siguiente manera al archivo de configuración de la aplicación:

    <configuration>
  <startup>
    <supportedRuntime version="version"/>
  </startup>
</configuration>

    El version atributo especifica la versión clR que se alinea con la versión de .NET Framework que admite la aplicación. Use las siguientes cadenas:

    • .NET Framework 1.0: "v1.0.3705"
    • .NET Framework 1.1: "v1.1.4322"
    • .NET Framework 2.0, 3.0 y 3.5: "v2.0.50727"
    • .NET Framework 4 y versiones posteriores: "v4.0"

    Puede agregar varios elementos <supportedRuntime>, ordenados según su preferencia, para especificar la compatibilidad con varias versiones de .NET Framework.

En la tabla siguiente se muestra cómo se instalan las opciones de archivo de configuración de la aplicación y las versiones de .NET Framework instaladas en un equipo para determinar la versión en la que se ejecuta una aplicación de .NET Framework 3.5. Los ejemplos son específicos de una aplicación de .NET Framework 3.5, pero puede usar una lógica similar a las aplicaciones de destino creadas con versiones anteriores de .NET Framework. Tenga en cuenta que el número de versión de .NET Framework 2.0 (v2.0.50727) se usa para especificar .NET Framework 3.5 en el archivo de configuración de la aplicación.

Configuración del archivo de aplicación.config En el equipo con la versión 3.5 instalada En el equipo con las versiones 3.5 y 4 o posteriores instaladas En el equipo con la versión 4 o versiones posteriores instaladas
Ninguno Se ejecuta en la versión 3.5 Se ejecuta en la versión 3.5 Muestra el mensaje de error que solicita al usuario que instale la versión correcta*
<supportedRuntime version="v2.0.50727"/> Se ejecuta en la versión 3.5 Se ejecuta en la versión 3.5 Muestra el mensaje de error que solicita al usuario que instale la versión correcta*
<supportedRuntime version="v2.0.50727"/>
<supportedRuntime version="v4.0"/>		 Se ejecuta en la versión 3.5 Se ejecuta en la versión 3.5 Se ejecuta en la versión 4 o versiones posteriores
<supportedRuntime version="v4.0"/>
<supportedRuntime version="v2.0.50727"/>		 Se ejecuta en la versión 3.5 Se ejecuta en 4 o versiones posteriores Se ejecuta en la versión 4 o posteriores
<supportedRuntime version="v4.0"/> Muestra el mensaje de error que solicita al usuario que instale la versión correcta* Compatible con la versión 4 o posteriores Se ejecuta en la versión 4 o posteriores

* Para obtener más información sobre este mensaje de error y formas de evitarlo, consulte Errores de inicialización de .NET Framework: Administración de la experiencia del usuario.

Consulte también

  • Last updated on