The Vista RSS Platform 

RSS has become the most ubiquitous ways of having information at your
fingertips. By subscribing to RSS feeds from the many different sites, you can
haveinformation delivered right to youwithout your going to it. Many RSS readers
are already available and now you can write your own RSS application for Windows
Vista without knowing the RSS XML format. In this article, we tell you how to
create one such simple RSS reader using this Vista API.In Vista, the RSS
platform consists of a number of components. Firstly, there is a Download &
Schedule engine that manages the download of syndicated content. The content can
be in any of the popular formats-RSS 0.9, 1.0, 2.0, ATOM, etc. A Merge
Processor takes care of recognizing the format and applying XSL Transformations
on the feeds, rendering them. Both these use Vista's Common Feedlist-a 'database'
of the URLs you are subscribed to. Over and above this is the RSS Object Model-a
COM API that allows you to program and use this entire platform very easily.

The RSS API is very simple to use. It consists of a FeedManager class that
contains a collection of FeedFolders. These in turn have a collection of Feeds,
which further contain FeedItems that contain FeedEnclosures. By adding a
reference to the FeedManager class you can easily enter the entire RSS
infrastructure on Vista and do any RSS related task like adding a new
subscription, viewing/ modifying/deleting existing feeds, etc. 

We'll create a .NET project for using the RSS API. Since this is a COM API,
all we need to do is add a reference in our solution to this. Create a new
Windows application project in VS 2005. Right click the solution and select 'Add
Reference'. In the dialog box, click the COM tab and scroll down till you can
select 'Microsoft Feeds, version 1.0'. Now in the code use the reference as:




// For the RSS Feeds COM API

using Microsoft.Feeds.interop;

using System.

// For managing COM interop

Runtime.InteropServices;

With this, you have RSS-enabled your application. So let's use this for actually creating an RSS reader. First drop a few controls on the form-a
Treeview, a Label, a Listbox and a Webbrowser control. Declare a variable as follows that can be used throughout the application in the main form's
class.

// The main entry into the RSS API

FeedsManager fm;

In the form's Load event, add the

following lines of code.

fm = new FeedsManagerClass();

IFeedFolder root = (IFeedFolder) fm.RootFolder;

EnumFolders(root);

The RSS reader created in this article will look like this when run

These lines of code get an entry into the API, find the root folder of the list
of RSS feeds you are subscribed to and then calls a function to enumerate the
feeds in the root folder. The EnumFolders method looks like this.

private void EnumFolders(IFeedFolder

rssFolder)

{

// If on *root* folder

if (rssFolder.name == "")

treeView1.Nodes.Add(

"RSS Feed List");

else

treeView1.Nodes.Add(

rssFolder.name);

// Get the list of feeds

IFeedsEnum rssFeeds = (IFeedsEnum) rssFolder.Feeds;

for (int i = 0; i < rssFeeds.Count; i++) {

// Get feed item

IFeed rssFeed =

(IFeed) rssFeeds.Item(i);

treeView1.Nodes<0>.Nodes.Add(

rssFeed.name);

Marshal.ReleaseComObject(

rssFeed);

}

}

This function is very simple. It adds the name of the folder it has been
passed (or a fixed string in the case of the root folder) to the Treeview
control and the feeds in that folder as sub-items below it.

For the Treeview, we add one event handler that will let us select a node (an
RSS feed) in it that will show us more

details of the feed. For this, the following handler is written.

private void treeView1_AfterSelect(

object sender, TreeViewEventArgs e)

{

TreeNode selected = e.Node;

listBox1.Items.Clear();

if (selected.Text != "RSS Feed List") {

// Ensure that the item clicked was not the folder

IFeed rssFeed = (IFeed)fm.GetFeed(selected.Text);

label1.Text= rssFeed.url;

for(int i=rssFeed.itemCount-1; i>0; i--)

{

IFeedItem rssFeedItem = (IFeedItem) rssFeed.GetItem(i);

listBox1.Items.Add(

rssFeedItem.Title);

}

}

}

This function simply gets the name of the node clicked in the Treeview and
gets the Feed object corresponding to that. It then displays the URL of the RSS
feed in the Label control and the list of RSS items in the Listbox control (in
descending order-with the latest news on the top).

Similarly, we have an event handler for the Listbox that displays the actual
news item in the Webbrowser control when clicked:

private void listBox1_SelectedIndexChanged(object sender, EventArgs e) {

IFeed rssFeed = (IFeed)fm.GetFeed(

treeView1.SelectedNode.Text);

IFeedItem rssItem = (IFeedItem)

rssFeed.GetItem(rssFeed.itemCount -

listBox1.SelectedIndex-1);

webBrowser1.DocumentText =

rssItem.Description;

}

This event gets the news item and displays its content in the Webbrowser
control. When you run this application, you have a RSS reader that can browse
your existing subscriptions, show you the URL associated with it and all the
items already downloaded and even view the details of any news item present.

The API allows you to do a lot more-add and manage subscriptions, download
attachments or update a feed, manage list type feeds etc. You can even create
enclosure specific RSS readers -for instance, a PodCast RSS Reader that shows
only RSS feeds with audio/video attachments. You can also integrate RSS into your product to get RSS delivered news about the product or
your company right within the application itself. The limit is your imagination.
So go ahead and use the RSS API of Vista to get information at your fingertips.