Description des formes de chaînes d’URL
Dernière modification : vendredi 16 avril 2010
S’applique à : SharePoint Foundation 2010
Microsoft SharePoint Foundation utilise différentes formes de chaînes d’URL, suivant le contexte et les membres en cours d’utilisation.
SharePoint Foundation analyse les chaînes d’URL afin de déterminer la forme de l’URL d’après un protocole spécifié (par exemple, http:) ou d’après l’insertion d’une barre oblique (/) dans la chaîne. Selon le membre particulier, vous pouvez utiliser les formes d’URL suivantes :
Une URL absolue qui spécifie un chemin d'accès complet et qui commence par la spécification d'un protocole. Par exemple, http://Serveur/[sites/]Site_Web/Lists/Titre_Liste/AllItems.aspx.
Une URL relative de serveur qui repose sur l’adresse du serveur et qui commence par une barre oblique, en spécifiant un chemin d’accès complet depuis le site Web de niveau supérieur jusqu’au nom du fichier. Par exemple, /[sites/]Site_Web/Lists/Titre_Liste/AllItems.aspx.
Une URL relative de site Web qui repose sur l’adresse d’un objet de site Web (SPWeb), qui ne commence pas par une barre oblique et qui spécifie un chemin d’accès complet depuis l’adresse du site Web jusqu’au nom du fichier. Par exemple, Lists/Titre_Liste/AllItems.aspx.
Une URL relative à un fichier ou à un dossier qui repose sur le dossier contenant le fichier sans aucune barre oblique et qui spécifie le nom du fichier. Par exemple, AllItems.aspx.
Notes
Il n’existe pas de concept « d’URL relative à une collection de sites » : par conséquent, le passage d’une telle URL peut entraîner l’échec du code.
Lorsque vous créez une URL vers un fichier image situé dans le répertoire %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\LAYOUTS\1033\IMAGES, spécifiez un chemin d’accès qui utilise le site Web racine de la collection de sites, mais n’incluez pas de sous-site dans le chemin d’accès. Par exemple, utilisez /_layouts/images/MyImage.gif pour un fichier image, mais pas /MySubsite/_layouts/images/MyImage.gif. La spécification d’un sous-site dans le chemin d’accès peut empêcher l’affichage de l’image, suivant, par exemple, la façon dont l’URL complète est construite à partir de l’emplacement où elle est utilisée. L’URL risque fortement d’échouer si elle ne commence pas que par /_layouts.
Jetons d’URL
SharePoint Foundation prend en charge les jetons suivants avec lesquels vous pouvez commencer une URL relative :
~site Lien relatif au site Web (SPWeb).
~sitecollection Lien relatif à la collection de sites (SPSite).
En outre, vous pouvez utiliser les jetons suivants dans une URL :
{ItemId} ID d’entier qui représente l’élément dans une liste.
{ItemUrl} URL de l’élément faisant l’objet d’une opération. Fonctionne uniquement pour les documents dans les bibliothèques.
{ListId} GUID qui représente la liste.
{SiteUrl} URL du site Web (SPWeb).
{RecurrenceId} Index de périodicité. Ce jeton n’est pas pris en charge dans les menus contextuels des éléments de liste.
Voir aussi
Concepts
Obtention de références aux sites, applications Web et autres objets clés
Tâches de développement SharePoint : comment faire...?
Utilisation des objets Liste et des collections