De quoi parle-t-on ?
ASP.NET AJAX Control Toolkit est un projet open-source intégré au framework Microsoft ASP.NET AJAX. Il s'agit d'un effort conjoint entre Microsoft et la communauté ASP.NET AJAX qui fournit une infrastructure puissante pour écrire des composants réutilisables, personnalisables et extensibles ASP.NET AJAX et des contrôles, ainsi que d'un riche éventail de contrôles qui peuvent être utilisé out-of-the-box pour créer une expérience Web interactive.
L'AJAX Control Toolkit contient plus de 30 contrôles qui vous permettent de créer facilement des pages Web interactives riches.
La liste complète des contrôles disponibles se trouve sur cette page:
http://www.asp.net/AjaxLibrary/AjaxControlToolkitSampleSite/Default.aspx
Intégration à une solution SharePoint 2013 sur Visual Studio 2012
A. Premièrement il vous faudra télécharger la version correspondant au framework .NET 4.5 à l'adresse suivante sur la plateforme CodePlex:
Dézipper finalement l'archive sur votre serveur pour pouvoir ensuite référencer les dlls.
B. Nous allons maintenant référencer les dlls suivantes dans le projet Visual studio :
- AjaxControlToolkit.dll
- AjaxMin.dll
C. Ajout des SafeControls à la solution: dans le dossier "Package" de votre solution cliquez sur le fichier Package.package pour le modifier, puis allez dans l'onglet "Advanced"
Cliquez sur Add puis sur "Add existing assembly", sélectionnez la dll AjaxControlToolKit depuis un sous-dossier de votre solution
- Name space :AjaxControlToolkit
- TypeName : *
- Assembly : AjaxControlToolkit, Version=4.5.7.1005, Culture=neutral, PublicKeyToken=28f01b0e84b6d53e
Effectuez la même manipulation avec le fichier AjaxMin.dll
- NameSpace: AjaxMin.dll
- TypeName: *
- Assembly : AjaxMin, Version=4.97.4951.28478, Culture=neutral, PublicKeyToken=21ef50ce11b5d80f
D.Ajoutez ensuite dans le fichier web.config de votre WebApplication situez sous le répertoire "C:\inetpub\wwwroot\wss\VirtualDirectories\[Your web application Port]" une référence à l'assembly référencé ou encore passez par une feature de scope Web Application avec l'event receiver suivant pour effectuer la modification automatiquement:
public override void FeatureActivated(SPFeatureReceiverProperties properties)
{
SPWebApplication webApp = properties.Feature.Parent as SPWebApplication;
var configModAssembly = new SPWebConfigModification
{
Name = "add[@assembly=\"AjaxControlToolkit, Version=4.5.7.1005, Culture=neutral, PublicKeyToken=28f01b0e84b6d53e\"]",
Owner = "AjaxControlToolkitWebConfig",
Path = "configuration/system.web/compilation/assemblies",
Type = SPWebConfigModification.SPWebConfigModificationType.EnsureChildNode,
Value = "<add assembly=\"AjaxControlToolkit, Version=4.5.7.1005, Culture=neutral, PublicKeyToken=28f01b0e84b6d53e\" />"
};
var configModAssembly2 = new SPWebConfigModification
{
Name = "add[@assembly=\"AjaxMin, Version=4.97.4951.28478, Culture=neutral, PublicKeyToken=21ef50ce11b5d80f\"]",
Owner = "AjaxControlToolkitWebConfig",
Path = "configuration/system.web/compilation/assemblies",
Type = SPWebConfigModification.SPWebConfigModificationType.EnsureChildNode,
Value = "<add assembly=\"AjaxMin, Version=4.97.4951.28478, Culture=neutral, PublicKeyToken=21ef50ce11b5d80f\" />"
};
webApp.WebConfigModifications.Add(configModAssembly);
webApp.WebConfigModifications.Add(configModAssembly2);
/*Call Update and ApplyWebConfigModifications to save changes*/
SPWebService.ContentService.WebApplications[webApp.Id].WebConfigModifications.Add(configModAssembly);
SPWebService.ContentService.WebApplications[webApp.Id].WebConfigModifications.Add(configModAssembly2);
SPWebService.ContentService.WebApplications[webApp.Id].Update();
SPWebService.ContentService.WebApplications[webApp.Id].WebService.ApplyWebConfigModifications();
}
E.Déplacez la section suivante de votre fichier master .html depuis la balise head vers la balise body.
après:
Ajoutez également une référence dans votre masterpage avec la ligne suivante:
<%@Register TagPrefix="ajaxToolkit" Namespace="AjaxControlToolkit" Assembly="AjaxControlToolkit, Version=4.5.7.1005, Culture=neutral, PublicKeyToken=28f01b0e84b6d53e" %>
Vous êtes maintenant prêt à utiliser les contrôles AjaxControlToolKit au sein de vos webparts.
