Compartir a través de

Configurar una aplicación ASP.NET para una versión de ASP.NET

  • Artículo

De forma predeterminada, cuando se instala .NET Framework en un equipo con una instalación existente, todas las aplicaciones ASP.NET se actualizan automáticamente para utilizar esa versión de .NET Framework. La única excepción son las aplicaciones que se enlazan a una versión incompatible o posterior del motor de tiempo de ejecución. Aunque las versiones posteriores de .NET Framework están diseñadas para ser compatibles con versiones anteriores, se puede configurar una aplicación ASP.NET para utilizar una versión anterior. En las secciones siguientes se describe el proceso de configuración de una aplicación ASP.NET para una versión específica de .NET Framework.

Ver la asignación de secuencia de comandos de una aplicación ASP.NET

Al administrar un equipo con múltiples versiones instaladas de .NET Framework, por lo general, suele ser útil ver la asignación de secuencia de comandos de una aplicación ASP.NET para determinar qué versión utiliza la aplicación. La asignación de secuencia de comandos de una aplicación ASP.NET se puede ver en la consola de administración de los Servicios de Internet Information Server.

Para ver la asignación de secuencia de comandos de una aplicación ASP.NET

  1. Abra la consola de administración de IIS, expanda el equipo local haciendo clic en el signo más y desplácese a la carpeta que contiene la aplicación ASP.NET.

  2. Haga clic con el botón secundario del mouse (ratón) en la carpeta Propiedades. Aparecerá el cuadro de diálogo Propiedades de la aplicación.

  3. En la ficha Directorio, haga clic en el botón Configuración. Aparecerá el cuadro de diálogo Configuración de la aplicación.

  4. En la ficha Asignaciones, seleccione una extensión de aplicación ASP.NET, como .asmx o .aspx.

    La columna Ruta de acceso del ejecutable del cuadro de diálogo contiene la ruta de acceso a la versión de la ISAPI de ASP.NET utilizada por la aplicación. De forma predeterminada, la ISAPI de ASP.NET se instala en la siguiente ubicación:

    raízdelsistema\Microsoft.NET\Framework\númerodeversión

    El número de versión que aparece en la ruta de acceso indica el número de versión de la ISAPI de ASP.NET utilizado por la aplicación. La versión de la ISAPI de ASP.NET determina la versión del motor de tiempo de ejecución que debe utilizar la aplicación.

Actualizar las asignaciones de secuencias de comandos mediante Aspnet_regiis.exe

Para que volver a configurar la asignación de secuencias de comandos en una aplicación ASP.NET sea más fácil, cada instalación de .NET Framework se suministra con una versión asociada de la herramienta Registro de IIS en ASP.NET (Aspnet_regiis.exe). Los administradores pueden utilizar esta herramienta para reasignar una aplicación ASP.NET a la versión de la ISAPI asociada con la herramienta.

Nota   Como la herramienta Aspnet_regiis.exe está vinculada a una versión específica de .NET Framework, para volver a configurar la asignación de secuencia de comandos en una aplicación ASP.NET, los administradores deben utilizar la versión apropiada de la herramienta. La herramienta Aspnet_regiis.exe sólo reconfigura la asignación de secuencia de comandos de una aplicación ASP.NET a la versión de la ISAPI asociada con la herramienta.

Además, se puede utilizar esta herramienta para mostrar el estado de todas las versiones instaladas de ASP.NET, registrar la versión asociada de ASP.NET, crear directorios de secuencias de comandos en el cliente y realizar otras operaciones de configuración.

Para utilizar Aspnet_regiis.exe para actualizar una asignación de secuencia de comandos de una aplicación ASP.NET

  1. Abra una ventana de comandos. (Haga clic en Inicio, haga clic en Ejecutar, escriba cmd y, por último, haga clic en Aceptar.)

  2. Desplácese al directorio que contiene la versión de la herramienta Aspnet_regiis.exe que desee utilizar. Recuerde que cada versión de .NET Framework se suministra con su propia versión. Normalmente, el archivo se encuentra en el siguiente directorio:

    raízdelsistema\Microsoft.NET\Framework\númerodeversión

  3. Utilice la opción -s o -sn de Aspnet_regiis.exe junto con la ruta de acceso a la aplicación para configurar las asignaciones de secuencias de comandos. El ejemplo siguiente muestra una línea de comandos que actualiza las asignaciones de secuencias de comandos para una aplicación denominada SampleApp1.

    Aspnet_regiis.exe -s W3SVC/1/ROOT/SampleApp1

Agrupación de aplicaciones en IIS 6.0

En las versiones de IIS anteriores a la versión 6.0 se utiliza el modelo de proceso de ASP.NET (Aspnet_wp.exe). En el modelo de proceso de ASP.NET, cada versión de la aplicación se ejecuta automáticamente en un proceso independiente en tiempo de ejecución. Todas las aplicaciones que utilizan la misma versión del motor de tiempo de ejecución comparten el mismo proceso (o los procesos en modo hospedaje multiproceso en una única máquina). Sin embargo, en la versión 6.0 de IIS se utiliza el modelo de proceso de esta versión (w3wp.exe) y se ofrece una nueva característica denominada agrupación de aplicaciones. La agrupación de aplicaciones permite ejecutar las aplicaciones en uno o varios procesos, siempre que compartan la misma designación de agrupación. Las aplicaciones asignadas a agrupaciones de aplicaciones diferentes nunca se ejecutan en el mismo proceso.

Cuando están instaladas múltiples versiones de .NET Framework en un equipo que utiliza IIS 6.0, se puede encontrar el siguiente mensaje de error en el registro de eventos de la aplicación.

No se pueden ejecutar dos versiones diferentes de ASP.NET en el mismo proceso IIS. Utilice la herramienta de administración de IIS para volver a configurar el servidor y ejecutar la aplicación en otro proceso separado.

Este error se produce cuando se configura la ejecución de más de una versión de ASP.NET en el mismo proceso. En un mismo proceso no pueden coexistir simultáneamente versiones diferentes de .NET Framework y del motor de tiempo de ejecución. Por tanto, una aplicación ASP.NET que utilice una versión específica del motor de tiempo de ejecución no debe compartir un proceso con otra aplicación que utilice una versión diferente. Este error se suele producir cuando se asignan dos o más aplicaciones a diferentes versiones de ASP.NET, aunque compartan la misma agrupación de aplicaciones.

Para utilizar la agrupación de aplicaciones, compruebe primero que el modo de aislamiento de IIS 5.0 está deshabilitado. A continuación, desplácese a la aplicación que desee en la consola de administración de los Servicios de Internet Information Server y asígnele una agrupación de aplicaciones. Si desea aislar la aplicación de las otras agrupaciones existentes, cree una nueva designación de agrupación.

Nota   El proceso de aislamiento de aplicaciones se configura manualmente.

Para deshabilitar el modo de aislamiento de IIS 5.0 en IIS 6.0.

  1. Abra la consola de administración de IIS y expanda el equipo local haciendo clic en el signo más.
  2. Haga clic con el botón secundario del mouse en la carpeta Sitios Web y haga clic en Propiedades.
  3. En la ficha Servicio, elimine la selección de la casilla de verificación Ejecutar el servicio Web en el modo de aislamiento IIS 5.0.

Para asignar una designación de agrupación a una aplicación ASP.NET en IIS 6.0

  1. Abra la consola de administración de IIS, expanda el equipo local haciendo clic en el signo más y desplácese hasta la carpeta que contiene la aplicación ASP.NET.
  2. Haga clic con el botón secundario del mouse en la aplicación y, a continuación, haga clic en Propiedades. Aparecerá el cuadro de diálogo de las propiedades de la aplicación.
  3. En la ficha Directorio, seleccione la designación de agrupación de aplicaciones que desee en la lista Agrupación de aplicaciones.

Para crear una designación de aplicaciones en IIS 6.0

  1. Abra la consola de administración de IIS y expanda el equipo local haciendo clic en el signo más.
  2. Haga clic con el botón secundario del mouse en la carpeta Agrupaciones de aplicaciones, haga clic en Nueva y, a continuación, haga clic en Agrupación de aplicaciones. Aparecerá el cuadro de diálogo Agregar nueva agrupación de aplicaciones.
  3. Escriba el nombre de la nueva agrupación en el cuadro de texto Agrupación de aplicaciones y, a continuación, haga clic en Aceptar.

Vea también

Compatibilidad con la ejecución simultánea en ASP.NET | Información general sobre simultaneidad de ASP.NET