Comment : mettre à niveau un projet Web ASP.NET AJAX 1.0 vers .NET Framework 3.5

Article
10/22/2014

Mise à jour : novembre 2007

Visual Studio 2008 inclut une nouvelle version d'ASP.NET AJAX, qui fournit des améliorations de la version 1.0 d'ASP.NET AJAX. Cette rubrique décrit comment mettre à niveau des sites Web ASP.NET AJAX 1.0 existants et des projets d'application Web pour utiliser la prise en charge d'AJAX dans .NET Framework 3.5 et Visual Studio 2008.

Mise à niveau vers la nouvelle version d'ASP.NET AJAX

Pour mettre à niveau un site Web ASP.NET AJAX ou un projet d'application Web

Effectuez une copie de sauvegarde du projet.
Démarrez Visual Studio 2008.
Ouvrez le projet. Effectuez l'une des actions suivantes :
- Si vous travaillez avec un site Web, dans le menu Fichier, cliquez sur Ouvrir un site Web, puis ouvrez le site Web ou le répertoire virtuel IIS.
- Si vous travaillez avec un projet d'application Web, dans le menu Fichier, cliquez sur Ouvrir un projet, accédez au fichier projet, puis ouvrez-le.
L'Assistant Conversion de Visual Studio démarre. Suivez les étapes de l'Assistant pour mettre à niveau le projet.
Lorsque Visual Studio 2008 vous invite à mettre à niveau le site Web, cliquez sur Oui.

Mise à jour de l'assembly ASP.NET AJAX Control Toolkit

Si votre application inclut des contrôles ou des extendeurs d'ASP.NET AJAX Control Toolkit, vous devez la mettre à niveau vers une nouvelle version du Control Toolkit pour qu'elle s'exécute avec .NET Framework 3.5. Vous pouvez télécharger la version actuelle d'ASP.NET AJAX 1.0 Control Toolkit à partir du site Web de Codeplex (en anglais).

Remarque importante :
Control Toolkit est une bibliothèque prise en charge par la communauté et non par Microsoft.

Pour mettre à jour l'assembly ASP.NET AJAX Control Toolkit

Téléchargez la version actuelle d'ASP.NET AJAX Control Toolkit pour .NET Framework 3.5. Vous pouvez télécharger le Control Toolkit à partir du site Web de Codeplex (en anglais).
Dans l'Explorateur Windows, cliquez avec le bouton droit sur le fichier .zip de Control Toolkit, puis cliquez sur Extraire tout...
Extrayez le contenu vers un dossier nommé AjaxControlToolkit-Framework3.5 dans le même répertoire.
Copiez l'assembly AjaxControlToolkit.dll à partir du répertoire AjaxControlToolkit-Framework3.5\SampleWebSite\Bin vers le répertoire Bin de votre application, en remplaçant la version antérieure de l'assembly Control Toolkit.

Vous pouvez éventuellement installer les contrôles d'ASP.NET AJAX Control Toolkit dans la Boîte à outils de Visual Studio.

Pour installer les contrôles d'ASP.NET AJAX Control Toolkit dans la Boîte à outils

Dans le site Web ou le projet ASP.NET AJAX 1.0, ouvrez une page Web ASP.NET (Web Form).
Cliquez avec le bouton droit sur la Boîte à outils puis sur Ajouter un onglet.
Attribuez un nom au nouvel onglet, tel que "ASP.NET AJAX Toolkit 1.0".
Cliquez avec le bouton droit sur le nouvel onglet puis sur Choisir les éléments….

Remarque :

Cette boîte de dialogue peut mettre quelque temps à s'afficher lors de sa première ouverture.
Dans la boîte de dialogue Choisir des éléments de boîte à outils, cliquez sur Parcourir….
Accédez à \AjaxControlToolkit-Framework3.5\SampleWebSite\Bin, sélectionnez AjaxControlToolkit.dll puis cliquez sur Ouvrir.

Les contrôles de Control Toolkit sont sélectionnés dans la boîte de dialogue Choisir des éléments de boîte à outils.
Cliquez sur OK.

Les contrôles sont ajoutés à la Boîte à outils.

Remarque :
Cette boîte de dialogue peut mettre quelque temps à s'afficher lors de sa première ouverture.

Utilisation de composants AJAX 1.0 dans un projet mis à niveau

Une nouvelle version de Microsoft ASP.NET AJAX Control Toolkit est disponible sous forme compilée en utilisant l'assembly ASP.NET AJAX (System.Web.Extensions) dans .NET Framework 3.5. Toutefois, votre application peut inclure des composants tiers ou des assemblys compilés en utilisant ASP.NET AJAX 1.0. Lorsque vous mettez à niveau un site Web vers .NET Framework 3.5, une section bindingRedirect est ajoutée au fichier Web.config de l'application ASP.NET AJAX 3.5. Cette section permet aux composants tiers précompilés de se lier à la version 3.5 de l'assembly System.Web.Extensions au lieu de se lier à la version 1.0.

Remarque :
La section bindingRedirect s'applique uniquement au moment de l'exécution. Au moment du design, le composant tiers fait référence à la version 1.0 de l'assembly System.Web.Extensions. Pour pouvoir utiliser le concepteur de contrôles, vous devez installer AJAX 1.0. Si possible, utilisez une version du composant compilé pour la version 3.5 de l'assembly System.Web.Extensions.