The purpose of this article is to illustrate how we can effectively make use of the Application Blocks within SharePoint 2007 Development Tasks.
If you have not read the blog post about the Enterprise Library and its application blocks, you can read it at MSDN.
For example, the Data Access Application block can be effectively used when writing Web Parts to implement the interaction of Web Parts with custom databases, or even the Caching Application Block to implement caching of data within the Web Part.
One of the main time consuming portions while doing development is always devoted to implementing the effective use of exception handling and logging.
A well designed application should always involve exception handling and logging, which involves:
- Carefully implementing
- Making use of multiple
catch filters to either recover out of a situation or display a friendly error message on screen.
finally blocks to release unmanaged memory objects.
Need for Using Structured Logging in MOSS 2007
Exceptions generated by user interface elements like Web Parts and controls can be simply displayed on the screen; however, exceptions generated by services like MOSS timer jobs and workflows can be quite tricky to handle.
They need to log full exception details and stack trace so that users can find out the cause of the exception.
Let's start with configuring the Logging Application Block to incorporate standard logging in MOSS 2007 ULS logs. The ULS logs are, by default, stored in the Logs folder under 12 hive. We will create a simple MOSS 2007 application to demonstrate the simplest logging to SharePoint ULS logs using the Enterprise Library.
Before proceeding, a quick grasp of the design of the Logging Application Block is necessary, which can be found here.
We will see how easy it has become to implement these functionalities with the core functionalities being contained in wrapper classes of the Enterprise Library.
Let's start on with writing a custom Trace Listener, which will trace all our logs to SharePoint logs. Fire up VS 2005 and create a Class Library project. We will create a custom class which implements the interface
Microsoft.Practices.EnterpriseLibrary. Logging.TraceListeners.CustomTraceListener. The interface requires the implementation of three methods:
WriteLine. The code for the same is shown below:
public class SharepointTraceListener:TraceListeners.CustomTraceListener
string app="Sample App";
public override void TraceData(TraceEventCache eventCache,
string source,TraceEventType eventType, int id, object data)
if (data is LogEntry && this.Formatter != null)
this.WriteLine(this.Formatter.Format(data as LogEntry));
public override void Write(string message)
TraceProvider.WriteTrace(0,level, Guid.Empty, assb,app,app, message);
public override void WriteLine(string message)
TraceProvider.WriteTrace(0, level, Guid.Empty, assb,app,app, message);
If you see the code above, it is awfully simple. It makes use of just one class
TraceProvider, which outputs the details of the trace to the log. The implementation of this class is given by Microsoft in the WSS 3 SDK here, so I am not going to repeat it here.
We can just include the same implementation in our project from this location.
Configuring the Logging Application Block for the Custom Trace Listener
To use our custom trace listener, we need to create custom application configuration file. This can be created from the Configuration Tool provided by Microsoft Enterprise Library. Fire up the configuration tool and choose New Application, and add a new Logging Application Block.
Right click the Trace Listeners section and choose New Custom Trace Listener, and select your custom Trace Listener. In our case, it's
Logging.SharepointTraceListener. Save the file as App.config.
Using our Configured Logging Application Block in Applications
Now, since everything is ready, we can make use of our custom app.config (along with the Enterprise Library binaries, obviously) in our MOSS development applications like Web Parts, timer jobs, workflows etc.
The steps needed for the same would be:
- Add the custom App.config to the VS 2005 project
- Add a reference to
- Use the
Logger classes of the Enterprise Library to output trace to SharePoint ULS logs using
Here is a sample SharePoint console application which I built to demonstrate this:
static void Main(string args)
using (SPSite site = new SPSite("http://madhur"))
catch (System.IO.FileNotFoundException ex)
LogEntry logEntry = new LogEntry();
logEntry.EventId = 100;
logEntry.Priority = 2;
logEntry.Message = ex.Message;
In the code above, if the SharePoint site as a specified URL is not found, the exception is directly traced to SharePoint ULS logs. The key thing to note here is that the location where the trace output is logged is completely encapsulated in App.config.
type="Logging.SharepointTraceListener, Logging, Version=126.96.36.199,
name="Sharepoint Trace Listener"
By just changing the highlighted line in our App.Config above, we can make the trace to be output to different trace listeners, email, database, flat file, XML file, and so on. This is the real power of the Microsoft Enterprise Library.
That's all! Feel free to analyze it, use it, modify it...