Répertoires virtuels dans les solutions SharePoint
Découvrez comment les modifications apportées au système de répertoire virtuel affectent la façon dont vous créez des solutions de batterie de serveurs SharePoint.
Rendre vos solutions compatibles avec le nouveau système de mode de l'interface utilisateur
Lorsque vous utilisez le Kit de développement logiciel (SDK) Microsoft SharePoint 2010, mais que vous développez pour SharePoint, vous devez tenir compte d’un changement dans le système de répertoire virtuel au cours de votre travail. La modification est un effet secondaire de la nouvelle fonctionnalité SharePoint qui permet à une collection de sites de s’exécuter en mode SharePoint 2010 ou SharePoint mode. Les modes sont parfois appelées versions de l'interface utilisateurou de niveaux de compatibilité . Pour les fichiers dans les dossiers virtuel _layouts ou _controltemplates, SharePoint doit utiliser la version des fichiers dans %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\ (parfois appelée la ruche 15) ou dans la correspondant ruche 14, selon le mode de la collection de sites. SharePoint ajoute « /15 » dans le chemin d’accès du répertoire virtuel juste après le nom du répertoire virtuel pour signaler que les fichiers SharePoint doivent être utilisés. L'absence de cette chaîne supplémentaire indique que les fichiers SharePoint 2010 doivent être utilisés.
Ce nouveau système a des implications pour vous lorsque vous développez des solutions et des applications SharePoint, en particulier lorsque vous utilisez le SDK SharePoint 2010. Dans n’importe quel SharePoint Add-in (qui s’exécute uniquement en mode SharePoint) et dans n’importe quelle solution SharePoint dont vous savez qu’elle ne sera utilisée que dans les collections de sites qui s’exécutent en mode SharePoint, vous devez ajouter le « /15 » vous-même à tous les chemins d’accès virtuels que vous créez dans votre _layouts _controltemplates solution/application. (sauf si le chemin d’accès pointe vers un fichier *.aspx), même si cette chaîne n’apparaît pas dans les instructions lues dans le SDK SharePoint 2010. Par exemple, si le SDK SharePoint 2010 vous demande d’utiliser , vous devez l’utiliser lorsque vous développez pour ~/_layouts/images/myimage.png ~/_layouts/15/images/myimage.png SharePoint.
Si vous souhaitez rendre votre solution compatibles avec les collections de sites de chaque mode, vous devez branches logique pour déterminer le mode de la collection de sites actuelle et construire le chemin d'accès virtuel en conséquence. La propriété CompatibilityLevel , qui est également disponible dans tous les modèles objet clients SharePoint et l'interface REST, est un endroit où votre code peut vérifier pour le mode. La classe SPUtility a également plusieurs nouvelles propriétés à l'aide à la gestion de niveau de compatibilité dans vos solutions. Ils ne sont pas disponibles dans les modèles objet clients. Enfin, il existe plusieurs contrôles dans SharePoint qui exposent une propriété UIVersion que votre code peut également utiliser pour rechercher le niveau de compatibilité actuel.
Notes
[!REMARQUE] Si le fichier dans le chemin d'accès virtuel est *.aspx, SharePoint détecte automatiquement le mode de la collection de sites actuelle et renvoyer le fichier à partir de la ruche appropriée. Si vous n'avez pas insérer le « / 15 » dans le chemin d'accès virtuel.