The core SharePoint Services platform is comprised of more than 3000 API's. The most fundamental of these are found in the Microsoft.SharePoint namespace. The classes in this namespace will be used in virtually every Web Part and application development effort, so this is a good place to start.
The four key classes you'll need to become familiar with first are SPContext, SPSite, SPWeb, and SPUser. The SPContext class represents the context of an HTTP request in SharePoint Services. The SPSite class represents a collection of sites, including the top-level site and all children sub-sites. The SPWeb class is used to represent a single site in SharePoint. And, the SPUser class is used to represent a single user. Using these classes together lets you access virtually all information about sites and users, both in and out of the current site context.
In most situations, you'll need to know in what site context your code is currently running. To obtain this information, use the following code:
SPWeb web = SPContext.Current.Web;
If you are interested in retrieving the current site collection, use this code:
SPSite siteCollection = SPContext.Current.Site;
And if you need to access a site collection for a different context, you can use the following approaches:
SPSite siteCollection = new SPSite( "http://yourdomain/sites/hr" );
or
SPSite siteCollection = new SPSite( siteGUID );
Many times you'll want to obtain the current user for the current site context. Give this a try:
SPWeb web = SPContext.Current.Web;
SPUser currentUser = web.CurrentUser;
If you want to use some of what we learned above in a custom Web Part development effort, your code may look something like the following:
protected override RenderContents( HtmlTextWriter writer )
{
// Obtain context of current site and user.
SPWeb web = SPContext.Current.Web;
SPUser user = web.CurrentUser;
// Display the current users name.
writer.WriteLine( "Greetings: " + user.Name );
}
Obviously, this is a very basic example, but I hope it gives you a clear idea of how to use the current site context to obtain information about the site and user for which your code is executing.
Regards
Lakmal Kankanamge
