Introduction:
This article discusses the construction of a simple application that may used to view RSS feeds from the desktop. The application allows the user to select a canned RSS feed or to key one. The RSS feed is opened and the article title and link nodes from the feed are placed into a tree view control; each title becomes the parent of the related link.
Figure 1: Application in Use
The title of the article occupies the parent node with the link node placed as the child of each title node. If the user clicks on any of the link nodes, the article associated with the title will be opened into a web browser control.
Figure 2: Canned RSS Feeds in drop down, current RSS feed on left side
The intent of the application was to provide a simple tool that may be used to organize and read RSS postings. The titles and links are recovered from the XML returned from the RSS service.
Getting Started:
In order to get started, unzip the included project and open the solution in the Visual Studio 2008 environment. In the solution explorer, you should note these files:
Figure 3: Solution Explorer
As you can see, the project is a win forms application containing only a single form. The form itself contains a tool strip control docked to the top with a text box used for entering RSS feed locations, a button control to open the RSS feed, and a combo box containing a collection of RSS feed which may be directly opened. The left hand side of the form contains a tree view control used to display the RSS feed titles and links; the right hand side contains a web browser control which is used to display the linked page.
The Main Form (frmRss.cs).
The main form is used to open the selected RSS feed as an XML document and to display them in TreeView format; form also places the story link as a child node to each title node.
If you'd care to open the code view up in the IDE you will see that the code file begins as follows:
using System;
using System.Collections;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Text;
using System.Windows.Forms;
using System.Xml;
using System.Xml.XPath;
Note that the additions of the System.Xml and System.Xml.XPath libraries are the only actual departure from the default.
Following the imports, class is defined and a constructor added. A local string variable it declared and used to hold the RSS feed URL. Within the constructor, the string variable used to point to the location of the RSS feed is zeroized as an empty string.
namespace RSSFeedSpeedReader
{
public partial class frmRss : Form
{
// the current path to an RSS feed
string mRssUrl;
/// <summary>
/// Constructor
/// </summary>
public frmRss()
{
InitializeComponent();
// zeroize rss feed line
mRssUrl = string.Empty;
}
Next up is the click event handler for the RSS Go button located on the form's tool strip control. Within this click event handler, the code is placed to query for only the RSS feed item title and link. These two values are loaded into the tree view and make it possible for the user to read the article title and then open the link into the web browser control to read it if they are interested in getting more information on the topic. This section of code in annotated and should be easy enough to follow using the comments:
/// <summary>
/// Open up an RSS Feed into the treeview control
/// </summary>
/// <param name="sender"></param>
/// <param name="e"></param>
private void tsRssGo_Click(object sender, EventArgs e)
{
try
{
// set the file path member var
mRssUrl = this.tsRssLocation.Text;
// Clear the treeview.
tvwRss.Nodes.Clear();
// set the wait cursor
this.Cursor = Cursors.WaitCursor;
// create a new xml doc
XmlDocument doc = new XmlDocument();
try
{
// load the xml doc
doc.Load(mRssUrl);
// return the cursor
this.Cursor = Cursors.Default;
}
catch (Exception ex1)
{
// return the cursor
this.Cursor = Cursors.Default;
// tell a story
MessageBox.Show(ex1.Message);
return;
}
// get an xpath navigator
XPathNavigator navigator = doc.CreateNavigator();
try
{
// look for the path to the rss item titles; navigate
// through the nodes to get all titles
XPathNodeIterator nodes =
navigator.Select("//rss/channel/item/title");
while (nodes.MoveNext())
{
// clean up the text for display
XPathNavigator node = nodes.Current;
string tmp = node.Value.Trim();
tmp = tmp.Replace("\n", "");
tmp = tmp.Replace("\r", "");
// add a new treeview node for this
// news item title
tvwRss.Nodes.Add(tmp);
}
// set a position counter
int position = 0;
// Get the links from the RSS feed
XPathNodeIterator nodesLink =
navigator.Select("//rss/channel/item/link");
while (nodesLink.MoveNext())
{
// clean up the link
XPathNavigator node = nodesLink.Current;
string tmp = node.Value.Trim();
tmp = tmp.Replace("\n", "");
tmp = tmp.Replace("\r", "");
// use the position counter
// to add a link child node
// to each news item title
tvwRss.Nodes[position].Nodes.Add(tmp);
// increment the position counter
position++;
}
}
catch (Exception ex)
{
MessageBox.Show(ex.Message, "RSS Feed Load Error");
}
// restore the cursor
this.Cursor = Cursors.Default;
}
catch (Exception ex2)
{
// snitch
MessageBox.Show(ex2.ToString(), "RSS Feed Initialization
Failure");
}
}
The next section of the code is used to load the link content into the web browser control. This is accomplished using the After Select event from the tree view control. When this event fires, the code merely examines the link text and, if it starts with 'http'; the function makes an attempt to load the link into the web browser control occupying the right hand panel in the main form.
/// <summary>
/// Use the after select event to open the link
/// into the web browser control
/// </summary>
/// <param name="sender"></param>
/// <param name="e"></param>
private void tvwRss_AfterSelect(object sender, TreeViewEventArgs e)
{
try
{
// get the first four characters from the link
string tmp = tvwRss.SelectedNode.Text.Substring(0, 4);
// test the link text and then
// navigate the browser to that link
if (tmp == "http")
webBrowser1.Navigate(tvwRss.SelectedNode.Text);
}
catch
{
// if it is not a link, skip it
}
}
The last method in the class is the handler for the canned feeds combo box selected index changed event; in this code, when the user selects a canned feed from the drop down list, that link is loaded into the tool strip's RSS Location text box control and the tool strip control's Rss Go button's click event is fired. That button click event handler will clear the tree view control and reload it with the information captured from the replacement RSS feed.
/// <summary>
/// If the user selects a canned RSS feed from the drop down,
/// load the text into the toolstrip RSS location text box and
/// then use the tsRssGo_Click event to launch the
/// page into the browser
/// </summary>
/// <param name="sender"></param>
/// <param name="e"></param>
private void tsCboFeeds_SelectedIndexChanged(object sender, EventArgs e)
{
tsRssLocation.Text = tsCboFeeds.SelectedItem.ToString();
tsRssGo_Click(this, new EventArgs());
}
}
}
Summary
This application demonstrates a simple way of building an RSS Feed reader through the manipulation of the RSS Feed's XML. This is a little different than most of the RSS Feeder reader's I have encountered in that it does not attempt to provide the standard set of information returned from the feed in a listbox or similar control; rather this approach only displays the headlines and provides the links to the main story using the tree view control and a web browser control; in that the user can scan the headlines and then pop open the link directly to display the main story in a web browser control. Of course you can pull addition information from the feed and display it using other added controls; the approach is certainly something that can be expanded upon; however this does provide a clean and simple interface to the RSS Feeds main points of information.