Répertoires virtuels dans les solutions SharePoint
Découvrez comment les modifications apportées au système d’annuaires virtuels affectent la façon dont vous créez des solutions de batterie de serveurs dans 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 prendre en compte un changement dans le système d’annuaire virtuel que vous devez prendre en compte lorsque vous travaillez. 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. Les modes sont parfois appelées versions de l'interface utilisateurou de niveaux de compatibilité . Pour les fichiers des dossiers _layouts virtuels ou _controltemplates, SharePoint doit utiliser la version des fichiers dans %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\ (parfois appelée ruche 15) ou dans les 14 ruches correspondantes, selon le mode de la collection de sites. SharePoint ajoute « /15 » dans le chemin 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 Kit de développement logiciel (SDK) SharePoint 2010. Dans n’importe quel complément SharePoint (qui s’exécute uniquement en mode SharePoint) et dans toute solution SharePoint qui ne sera utilisée que dans les collections de sites qui s’exécutent en mode SharePoint, vous devez ajouter vous-même le « /15 » à tous les _layouts chemins virtuels et _controltemplates que vous créez dans votre 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 que vous lisez dans le Kit de développement logiciel (SDK) SharePoint 2010. Par exemple, si le Kit de développement logiciel (SDK) SharePoint 2010 vous demande d’utiliser ~/_layouts/images/myimage.png, vous devez utiliser ~/_layouts/15/images/myimage.png lorsque vous développez pour 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 d’objet client SharePoint et l’interface REST, est un endroit où votre code peut vérifier 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.
Remarque
[!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.