Using SPFolder SharePoint Object

SPFolder is one of the SharePoint object and it is a folder in the SharePoint list.To access 

an SPFolder object, first we need to retrieve an SPListItem object and use

the Folder property of that "SPListItem" which will return an SPFolder if the list item is a folder,

or else it  will returns null. 

Following are some of the properties which SPFolder exposed.

S.No.	Property Name	Description
1.	Name	Name of the folder
2.	Url	This return the site-relative URL of the folder
3.	Files	This returns an SPFileCollection object that contains SPFile objects representing all the files found in the folder
4.	Item	Returns the SPListItem object that corresponds to the folder
5.	SubFolders	This returns an SPFolderCollection object that contains SPFolder objects for all the subfolders contained within the folder
6.	Exists	This returns a bool value that indicates whether the folder exists
7.	Delete()	This method that deletes the folder
8.	CopyTo(string)	It Copies the folder and its contents to the URL specified by the string parameter
9.	MoveTo(string)	Moves the folder and its contents to the URL specified by the string parameter
10.	ItemCount	The count of children of this folder including subfolders
11.	ServerRelativeUrl	This return the server-relative URL for the folder

The following WebPart  shows how to access the SPFolder object using SharePoint Object Model.



using System;
using System.ComponentModel;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using Microsoft.SharePoint;
using Microsoft.SharePoint.WebControls;
using System.Linq;
using System.Text;
using System.Collections;
using System.Collections.Generic;
using System.Data;


namespace SPFolderDemo
{

 [ToolboxItemAttribute(false)]
    public class SPFolerSample : WebPart
    {

      StringBuilder spFolderSb = new StringBuilder();
        Literal SpLiteral = new Literal();
     


 protected override void CreateChildControls()
        {

            try
            {
SPList list=null
using(SPWeb web=SPContext.Current.Web)
{
list=web.List["SharedDocuments"];
}
SPListItem item=list.item[0];//for testing pointing to index "0"
SPFolder folder=item.Folder;
spFolderSb.Append("Folder Details");
spFolderSb.Append("Folder url:");
spFolderSb.Append(folder.Url);
spFolderSb.Append("Folder contains file");
spFolderSb.Append(folder.Files.Count);
spFolderSb.Append("Is Folder contains sub folder");
spFolderSb.Append(folder.SubFolder.Co);

SpLiterall.Text = spFolderSb.ToString();
this.Controls.Add(SpLiteral);


            }
            catch (Exception ex)
            {
                String.Format("Exception. ", ex);
            }

       }
    }

List E-mail Events and SPEmailEventReceiver

The class SPEmailEventReceiver has only one method " EmailReceived  " which is used trap the event when a list receives an email message.

To implement "EmailReceived" this method we need to create a class by inheriting the SPEmailEventReciever class.


The method "EmailReceived" accepts three parameters  (SPList,SPEmailMessage,String)
1. SPList
The SPList parameter actually represents the list that received the e-mail message which can be any List Type.

2. SPEmailMessage
SPEmailMessage is the actual e-mail that was send to the target list,We can use this parameter to get to the parts of the e-mail message and read the sender information, body of the e-mail, and any attachments ect.

3.String value.


The last parameter which is of String data type which is also called as receiverData , is a string and it contains the event receiver definition data.


sample code


 public class SampleEmailReceivedDemo: SPEmailEventReceiver
    {
        public override void EmailReceived(SPList targetList,SPEmailMessage SpMessage,string receiverData)
        {
            SPListItem listItem = targetList.Items.Add();
            listItem["Subject"] = SpMessage.Headers["Subject"];
            listItem["MessageBody"] = SpMessage.HtmlBody;
            listItemUpdate();
        }
    }

Using SPAlert in SharePoint

In SharePoint Alerts are very important ,alert can be an email  message send to end user or it may be Short Message Service(SMS) from the SharePoint.In many situations it is required to configure alerts for the Lists/Libraries in SharePoint.

For example let us say you have a Quality Assurance SharePoint Site which has a document library related to documents about the process and other documents,and it is a mandatory to all the employees to follow the Quality process and even if there is any change or added new process,in this it is required for employee to alert if there is any modifications/added any new documents to this library.

Using SharePoint Model it is possible to know about the user's alerts using SPAlert class.

The Following code samples shows how to user's alert using SPAlert class.

SPSite mySiteCollection=null;
SPWeb mySPweb=null;
   Try
       {
//Get the SPSite by passing the url
mySiteCollection = new SPSite("http://QualityAssuranceSite /")
mySPweb = mySiteCollection.OpenWeb("Quality")
SPUserCollection  users = mySPweb .Users;
       //Iterate through each users in site
         foreach (SPUser user in users)
            {
              //Get alerts collections for the individual user
             SPAlertCollection alerts = user.Alerts;
         foreach (SPAlert alert in alerts)
            {
             
           // you can access the properties and methods from the alert object "alert"
//Title
string alertTitle=alert.Title;
//AlertFrequency
alert.AlertFrequency = Microsoft.SharePoint.SPAlertFrequency.Immediate;
       alert.Update();

            }
           }

}
Catch(SPExecption exception)
{
    Throw exception
}
Finally
{
    mySiteCollection.Dispose();
    mySPweb.Dispose();
}

Property Name	More Information/Description
AlertTemplate	Gets or sets the alert template which defines the content and format of an alert message which can be an e-mail version of the alert, it also defines the style and rendering.
AlertTemplateName	The alert template name.
AlertTime	Date and time for sending the alert.
AlertType	Which can be a list or document library, a list item or document, or a custom object?
AlwaysNotify	It can be a daily or weekly alert is always sent, even if there is no matching event.
DeliveryChannels	The delivery method of the alert.
DynamicRecipient	It defines the event data to used to populate the e-mail recipient field in the alert.
EventType	Type of event to which the alert applies.
ID	ID of the alert.
Item	The list item or document to which the alert applies.
ItemID	The list item or document to which an alert applies in the parent collection of list items.
List	The list or document library to which the alert applies.
ListID	The GUID of the list or document library to which the alert applies.
ListUrl	The site-relative URL of the list to which the alert applies.
MatchId	Gets or sets the pre-filtering GUID for an externally matched alert.
UserId	Gets or sets the ID of the user who created the alert.

Different Types of Libraries in the SharePoint

The following are the different types of libraries available in the SharePoint.


Document library: These are the standard library type used for the majority of file types.This is the most commonly used library type.

Form library:  It is being designed to forms created using InfoPath. When we create a form in InfoPath 2010 and it is possible to publish to a form library

Wiki page library: It is used to stores wiki pages which is mainly used Wiki page Site.

Picture library. It is mainly used to stores images.

Note: All these library types store files. Each type enables versioning to be specified, but

they differ in the kinds of files that they are designed to store

Difference between a List and a Library in SharePoint

The main difference between a Library and a List is that an item in a Library must

contain a file.

The document library mainly it used to store files and it is accompanied by metadata for the respective items in the document library.

The Custom Lists/List type is used mainly to store the data/information.

The Document Library always provides the version  of the files which the items are created in the document library.

In both the cases the content types can be associated.

How to create Custom Field Types in SharePoint

There are situation in which it is required that we need to create controls which can be combination of one or more controls,usually controls are .net controls and SharePoint controls,in SharePoint also provides to create SharePoint custom field types by inheriting from one of the  builrt-in field type classes, such as SPFieldText, SPFieldNumber, SPFieldDateTime, and SPFieldMultiColumn. 

For Example

public class EmployeeJoinDate : SPFieldDateTime {

//Code comes here custom field type implementation

}

public class EmployeePANNumber : SPFieldText {

//Code comes here custom field type implementation

}

public class EmployeeSkills : SPFieldMultiColumn {

// custom field type implementation

}

public class EmployeementStatus : SPFieldText {

// custom field type implementation

}

Using ClientContext in SharePoint

In SharePoint context object provides an entry point into the associated application programming interface (API) that can be used to gain access to other objects.When we have access to the objects, we may interact with the scalar properties like Name, Title, Url of the object.

The ClientContext class can be used in both the managed and Silverlight object models which  inherits from the ClientContextRuntime class. With the help of ClientContext class, we can get a valid run-time context

by passing in the Uniform Resource Locator (URL) of a site.

It also provides several members that are required to access data and invoke methods on the server.

In SharePoint SP.ClientContext class which used in the JavaScript client object model is actually inherits from the SP.Client.ContextRuntime class which provides equivalent functionality to the ClientContext class found in the managed and Silverlight client object models. 

It is possible to get a run-time context in the JavaScript model using the SP.ClientContext class

and  can pass a URL. Which is different in managed and Silverlight models

Sample code shows different ways to access the sharepoint objects in client object model

1.Using Managed Code

//Managed Client Object Model

using (ClientContext context = new ClientContext("http://DemoSite"))

{

Site siteCollections = context.Site;

context.Load(siteCollections);

context.ExecuteQuery();

//access  scalar properties

string url = siteCollection.Url;

}

2.Using Silverlight Client Object Model

using (ClientContext context = new ClientContext("http://DemoSite"))

{

Site siteCollections =context .Site;

context .Load(siteCollections);

context .ExecuteQuery();

}

3.Using JavaScript Client Object Model

var siteCollections;

function getMySiteCollection

{

var context = new SP.ClientContext("/");

siteCollections = context.get_site;

context.load(site);

context.executeQueryAsync(Issuccess, Isfailure);

}

function Issuccess {

string url = siteCollection.get_url;

alert(url);

}

function Isfailure {

alert("It is Failed!");

}