Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

SPControl.GetContextSite - Méthode

Retourne la collection de sites qui sert de contexte pour la demande.

Espace de noms :  Microsoft.SharePoint.WebControls
Assembly :  Microsoft.SharePoint (dans Microsoft.SharePoint.dll)

public static SPSite GetContextSite(
	HttpContext context
)

Paramètres

context
Type : System.Web.HttpContext

Un objet System.Web.HTTPContext , qui encapsule le contexte spécifique à HTTP qui est utilisé par le serveur pour traiter les demandes de site.

Valeur renvoyée

Type : Microsoft.SharePoint.SPSite
Un objet Microsoft.SharePoint.SPSite qui représente la collection de sites.

  • La méthode GetContextSite est utilisée dans le code en cours d'exécution au sein d'un contexte HTTP qui est intégré à un déploiement de Windows SharePoint Services. Le code peut être utilisé dans un composant WebPart dans un service Web personnalisé (dans _vti_bin), ou dans une Application Web (dans _layouts) ou la page ASPX. Dans chacun de ces cas, la solution est disponible pour n'importe quel site SharePoint sur le serveur Web frontal, et la méthode GetContextSite renvoie l'objet SPSite pour la demande HTTP en cours. Par exemple, une page ASPX personnalisée (_layouts/1033/MyItems.aspx) qui retourne tous les éléments de liste créés par l'utilisateur qui accède à la page serait disponible pour une utilisation dans tous les sites sur le serveur Web en accédant à l'URL comme suit :

  • http:// nom_serveur /_layouts/1033/MyItems.aspx

  • http:// nom_serveur /sites/ Site_Collection /_layouts/1033/MyItems.aspx

  • http:// nom_serveur / sous-site /_layouts/1033/MyItems.aspx

N'utilisez pas la méthode Dispose ou Close de la classe SPSite pour fermer l'objet retourné par la méthode GetContextSite . Permettent à la place de SharePoint Foundation ou votre application portail gérer l'objet.

Pour plus d'informations, consultez Getting References to Sites, Web Applications, and other Key Objects.

L'exemple de code suivant utilise la méthode GetContextSite en conjonction avec la méthode GetContextWeb pour renvoyer un objet de collection de sites et un objet site sur une page .aspx.

[Visual Basic .NET]
<% Dim siteCollection As SPSite = SPControl.GetContextSite(Context)
Dim site As SPWeb = SPControl.GetContextWeb(Context) %>
[C#]
<% SPSite siteCollection = SPControl.GetContextSite(Context); 
   SPWeb site = SPControl.GetContextWeb(Context); %>

Afficher: