Cómo: Actualizar un proyecto web de ASP.NET AJAX 1.0 a .NET Framework 3.5

Artículo
10/22/2014

Actualización: noviembre 2007

Visual Studio 2008 incluye una nueva versión ASP.NET AJAX, que incorpora mejoras respecto a la versión 1.0 de ASP.NET AJAX. En este tema se describe cómo actualizar los sitios web y los proyectos de aplicación web de ASP.NET AJAX 1.0 para que utilicen la compatibilidad para AJAX de .NET Framework 3.5 y Visual Studio 2008.

Actualizar a la nueva versión de ASP.NET AJAX

Para actualizar un sitio web o un proyecto de aplicación web de ASP.NET AJAX

Realice una copia de seguridad del proyecto.
Inicie Visual Studio 2008.
Abra el proyecto. Siga uno de los procedimientos siguientes:
- Si está trabajando con un sitio web, en el menú Archivo, haga clic en Abrir sitio Web y, a continuación, abra el sitio web o el directorio virtual de IIS.
- Si está trabajando con un proyecto de aplicación web, en el menú Archivo, haga clic en Abrir proyecto, vaya al archivo de proyecto y ábralo.
Se inicia el Asistente de conversión de Visual Studio. Siga las instrucciones del asistente para actualizar el proyecto.
Cuando Visual Studio 2008 le pregunte si desea actualizar el sitio web, haga clic en Sí.

Actualizar el ensamblado ASP.NET AJAX Control Toolkit

Si su aplicación incluye controles o extensores de ASP.NET AJAX Control Toolkit, debe actualizar a una nueva versión de Control Toolkit para que se ejecuten con .NET Framework 3.5. Puede descargar la versión actual de ASP.NET AJAX 1.0 Control Toolkit en el sitio web de Codeplex.

Nota importante:
Control Toolkit es una biblioteca admitida por la comunidad para la que Microsoft no proporciona soporte.

Para actualizar el ensamblado ASP.NET AJAX Control Toolkit

Descargue la versión actual de ASP.NET AJAX Control Toolkit para .NET Framework 3.5. Control Toolkit está disponible en el sitio web de Codeplex.
En el Explorador de Windows, haga clic con el botón secundario del mouse en el archivo .zip de Control Toolkit y, a continuación, haga clic Extraer todo.
Extraiga el contenido en una carpeta denominada AjaxControlToolkit-Framework3.5 en el mismo directorio.
Copie el ensamblado AjaxControlToolkit.dll desde AjaxControlToolkit-Framework3.5\SampleWebSite\Bin en el directorio Bin de la aplicación y reemplace la versión anterior del ensamblado Control Toolkit.

También puede instalar los controles de ASP.NET AJAX Control Toolkit en el Cuadro de herramientas de Visual Studio.

Para instalar los controles de ASP.NET AJAX Control Toolkit en el Cuadro de herramientas

En el sitio o proyecto web de ASP.NET AJAX 1.0, abra una página web ASP.NET (Web Forms).
Haga clic con el botón secundario del mouse en el Cuadro de herramientas y, a continuación, haga clic en Agregar ficha.
Asigne un nombre a la ficha, por ejemplo, "ASP.NET AJAX Toolkit 1.0".
Haga clic con el botón secundario del mouse en la nueva ficha y, a continuación, haga clic en Elegir elementos....

Nota:

Podría haber una demora cuando este cuadro de diálogo se abre por primera vez.
En el cuadro de diálogo Elegir elementos del cuadro de herramientas, haga clic en Examinar… .
Vaya a \AjaxControlToolkit-Framework3.5\SampleWebSite\Bin, seleccione AjaxControlToolkit.dll y haga clic en Abrir.

Los controles de Control Toolkit aparecen seleccionados en el cuadro de diálogo Elegir elementos del cuadro de herramientas.
Haga clic en Aceptar.

Los controles se han agregado al Cuadro de herramientas.

Nota:
Podría haber una demora cuando este cuadro de diálogo se abre por primera vez.

Utilizar los componentes de AJAX 1.0 en un proyecto actualizado

Existe una nueva versión de Microsoft ASP.NET AJAX Control Toolkit que se compila mediante el ensamblado ASP.NET AJAX (System.Web.Extensions) de .NET Framework 3.5. Sin embargo, la aplicación podría incluir componentes o ensamblados de terceros compilados con ASP.NET AJAX 1.0. Cuando se actualiza un sitio web a .NET Framework 3.5, se agrega una sección bindingRedirect al archivo Web.config de la aplicación de ASP.NET AJAX 3.5. Esta sección permite que los componentes precompilados de terceros enlacen a la versión 3.5 del ensamblado System.Web.Extensions en lugar de enlazar a la versión 1.0.

Nota:
La sección bindingRedirect sólo se aplica en tiempo de ejecución. En tiempo de diseño, el componente de terceros hace referencia a la versión 1.0 del ensamblado System.Web.Extensions. Para que el diseñador de controles funcione, debe instalar AJAX 1.0. Si es posible, debe obtener una versión del componente compilado para la versión 3.5 del ensamblado System.Web.Extensions.