ASPNETRSSToolkit Wiki & Documentation Rss Feed

New Comment on "Consuming with RssDocument"

andrelasantos — Wed, 06 Feb 2013 18:25:11 GMT

I have troubles with ATOM format. The first link URL is given for all following RSS itens, even with correct link set.... How do i solve it?

New Comment on "Consuming With RssDataSource"

accumed — Mon, 14 Mar 2011 19:41:21 GMT

Had lots of trouble with this. To add to the toolbox, "tools" / "choose toolbox items" then browse to dll. Had trouble with add assembly System.Web.Extensions, files in App_code, and System.Net.Sockets.SocketException. Not worth fooling around with further without more help.

New Comment on "Consuming With RssDataSource"

accumed — Thu, 10 Mar 2011 19:51:32 GMT

Got stuck fast. How do you "add the RssDataSource and RssHyperLink to the Toolbox in Visual Studio"?

New Comment on "Consuming Feeds with RssDll Compiler"

russellshome — Thu, 11 Nov 2010 09:30:59 GMT

I generated a class from my wordpress feed (C#) but when i try it, all i get is an error: Cannot serialize member 'Title' of type RussellWPFeedTitle. XmlAttribute/XmlText cannot be used to encode complex types. Description: An unhandled exception occurred during the execution of the current web request. Please review the stack trace for more information about the error and where it originated in the code. Exception Details: System.InvalidOperationException: Cannot serialize member 'Title' of type RussellWPFeedTitle. XmlAttribute/XmlText cannot be used to encode complex types. Source Error: Line 82: } Line 83: Line 84: XmlSerializer serializer = new XmlSerializer(typeof(T)); Line 85: using (StringReader reader = new StringReader(xml)) Line 86: { Source File: E:\RussellProgramming\ProjectsVS2010\Timesheet\ThirdParty\RSSToolkit\RssToolkit\Rss\RssXmlHelper.cs Line: 84 .. etc...

New Comment on "Consuming With RssDataSource"

gminhas — Fri, 10 Jul 2009 03:48:38 GMT

How to handle if feed gives error

New Comment on "Publishing a feed using ToXML"

tigermain — Mon, 29 Jun 2009 12:12:07 GMT

This is a great project and I am implementing it in our open source MVC CMS. However I have one issue with this code, for some reason Firefox is displaying the source code with many illegal characters and therefore does not render the xml page, whilst IE seems to be able to read it properly. Any ideas?

New Comment on "Consuming Feeds with a Build Provider"

svawebmaster — Thu, 05 Mar 2009 17:15:11 GMT

I am unable to get the buildProvider to work for this toolkit. I added the buildproviders for .rss and .rssdl to my web.config as well as the appSettings keys. I then added a reference in my Bin folder to the RSSToolkit.dll. Next I created a .rss file called "MyFeed.rss". Nothing happened, no classes were automatically created as described. I then ran a build of my project and still nothing. What am I missing here? Any help is GREATLY appreciated! Thanks! :)

UPDATED WIKI: Publishing a feed using ToXML

IDisposable — Sat, 16 Jun 2007 05:16:25 GMT

Publishing a feed using RssDocument.ToXML

The weak-typed RssDocument class, as well as the strong-typed classed generated by the RssDll.exe command link compiler or the Build Provider include a ToXml method, which can be used to serialize and publish the feed:

public string ToXml(DocumentType outputType);

This method accepts a enum DocumentType argument that specifies what format the emitted XML should have. The options are listed:

    Rss,
    Opml,
    Atom,
    Rdf

To publish your feed as an Atom format feed from RssDocument, you can do the following inside an ASP.Net HttpModule or an HttpHandler:

 
string outputXml = rssDocument.ToXml(DocumentType.Atom); // Publish as Atom
XmlDocument document = new XmlDocument();
document.LoadXml(outputXml);
context.Response.ContentType = "text/xml";
document.Save(HttpContent.Current.Response.OutputStream);

As seen in the above sample code, you can decide the format of the output feed from the query-string. The default HttpHandler uses the outputtype query-string parameter and the values can be rss, rdf, atom or opml for the respective feed formats.

A sample of the feed emitted by the code above is shown here:

UPDATED WIKI: Publishing a feed using ToXML

IDisposable — Sat, 16 Jun 2007 05:16:05 GMT

Publishing a feed using RssDocument.ToXML

public string ToXml(DocumentType outputType);

This method accepts a enum DocumentType argument that specifies what format the emitted XML should have. The options are listed:

    Rss,
    Opml,
    Atom,
    Rdf

To publish your feed as an Atom format feed from RssDocument, you can do the following inside an ASP.Net HttpModule or an HttpHandler:

 
string outputXml = rssDocument.ToXml(DocumentType.Atom); // Publish as Atom
XmlDocument document = new XmlDocument();
document.LoadXml(outputXml);
context.Response.ContentType = "text/xml";
document.Save(HttpContent.Current.Response.OutputStream);

UPDATED WIKI: Publishing a feed using ASHX handler

IDisposable — Sat, 16 Jun 2007 05:04:38 GMT

Using an ASHX handler to publish a feed

When using the ASP.Net Build Provider mechanism, the RssToolkit will automatically detect certain files created or modified in the filesystem. It automatically generates strong-typed classes for those files and compiles the code. This occurs for any files with the extension configured in the web.confg file (typically .rss and .rssdl). This class library is used to consume a feed as documented in Consuming Feeds with a Build Provider. In addition, the RssToolkit also generates an HttpHandler derived class which you can use as a base-class from which you can then inherit from to create code that publishes your feed.

In the samples provided. The App_Code folder has Sample5.Rss file that defines a custom feed's contents:

<?xml version="1.0" encoding="utf-8"?>
<rss version="2.0">
    <channel>
        <title>Sample Channel</title>
        <link>~/RssHyperlinkFromCustomClass.aspx</link>
        <description>Channel For Scenario5 in ASP.NET RSS Toolkit samples.</description>
        <ttl>10</ttl>
        <name></name>
        <user></user>
        <pubDate>Tue, 10 Apr 2007 23:01:10 GMT</pubDate>
        <lastBuildDate>Tue, 10 Apr 2007 23:01:10 GMT</lastBuildDate>
        <webMaster>webmaster@email.com</webMaster>
        <item>
            <title></title>
            <description></description>
            <link></link>
        </item>
        <item>
            <title></title>
            <description></description>
            <link></link>
        </item>
    </channel>
</rss>

When the file is created or modified RssToolkit's Build Provider automatically generates code and compiles it based on the schema of this file. It prefixes all the generated classes with Sample5. So like the weak-typed RssDocument there will be a parallel Sample5Rss class; RssChannel will have a parallel Sample5Channel class; and RssItem will have a parallel Sample5Item class. The classes can be used to build up the contents of the feed in a strong-typed way from whatever datasource defines the feed contents. Indeed, the feed contents could be loaded from any compliant place, including a file or a fetch from a foreign URL that the client cannot access.

The Build Provider also creates a default HttpHandler derived class called Sample5HtppHandlerBase which inherits from RssHttpHandlerBase. You can then create a custom .ashx HttpHandler which inherits from the Sample5HttpHandlerBase class and in the code-behind for that page you simply build up the contents of the feed.

<%@ WebHandler Language="C#" Class="RssHyperLinkFromCustomClass" %>
 
using System;
using System.Collections.Generic;
using System.Web;
using RssToolkit.Rss;
 
public class RssHyperLinkFromCustomClass: Sample5HttpHandlerBase
{
    protected override void PopulateRss(string rssName, string userName)
    {
        Rss.Channel = new Sample5Channel();
        
        Rss.Channel.Items = new List<Sample5Item>();
        if (!string.IsNullOrEmpty(rssName))
        {
            Rss.Channel.Title += " '" + rssName + "'";
        }
 
        if (!string.IsNullOrEmpty(userName))
        {
            Rss.Channel.Title += " (generated for " + userName + ")";
        }
 
        Rss.Channel.Link = "~/scenario6.aspx";
        Rss.Channel.Description = "Channel For Scenario6 in ASP.NET RSS Toolkit samples.";
        Rss.Channel.Ttl = "10";
        Rss.Channel.User = userName;
 
        Sample5Item item = new Sample5Item();
        item.Title = "CodeGeneratedClass";
        item.Description = "Consuming RSS feed programmatically using strongly typed classes";
        item.Link = "~/CodeGeneratedClass.aspx";
        Rss.Channel.Items.Add(item);
 
        item = new Sample5Item();
        item.Title = "ObjectDataSource";
        item.Description = "Consuming RSS feed using ObjectDataSource";
        item.Link = "~/ObjectDataSource.aspx";
        Rss.Channel.Items.Add(item);
    }    
}

When you navigate to this handler, the document (in RSS format) would look like this:

UPDATED WIKI: Publishing a feed using ASHX handler

IDisposable — Sat, 16 Jun 2007 05:03:26 GMT

Using an ASHX handler to publish a feed

When using the ASP.Net Build Provider mechanism, the RssToolkit will automatically detect certain files created or modified in the filesystem. It automatically generates strong-typed classes for those files and compiles the code. This occurs for any files with the extension configured in the web.confg file (typically .rss and .rssdl). This class library is used to consume a feed as documented in Consuming Feeds with a Build Provider. In addition, the RssToolkit also generates an HttpHandler derived class which you can use as a base-class from which you can then inherit from to create code that publishes your feed.
In the samples provided. The App_Code folder has Sample5.Rss file that defines a custom feed's contents.

<?xml version="1.0" encoding="utf-8"?>
<rss version="2.0">
    <channel>
        <title>Sample Channel</title>
        <link>~/RssHyperlinkFromCustomClass.aspx</link>
        <description>Channel For Scenario5 in ASP.NET RSS Toolkit samples.</description>
        <ttl>10</ttl>
        <name></name>
        <user></user>
        <pubDate>Tue, 10 Apr 2007 23:01:10 GMT</pubDate>
        <lastBuildDate>Tue, 10 Apr 2007 23:01:10 GMT</lastBuildDate>
        <webMaster>webmaster@email.com</webMaster>
        <item>
            <title></title>
            <description></description>
            <link></link>
        </item>
        <item>
            <title></title>
            <description></description>
            <link></link>
        </item>
    </channel>
</rss>

When the file is created or modified RssToolkit's Build Provider automatically generates code and compiles it based on the schema of this file. It prefixes all the generated classes with Sample5. So like the weak-typed RssDocument there will be a parallel Sample5Rss class; RssChannel will have a parallel Sample5Channel class; and RssItem will have a parallel Sample5Item class. The classes can be used to build up the contents of the feed in a strong-typed way from whatever datasource defines the feed contents. Indeed, the feed contents could be loaded from any compliant place, including a file or a fetch from a foreign URL that the client cannot access.
The Build Provider also creates a default HttpHandler derived class called Sample5HtppHandlerBase which inherits from RssHttpHandlerBase. You can then create a custom .ashx HttpHandler which inherits from the Sample5HttpHandlerBase class and in the code-behind for that page you simply build up the contents of the feed.

<%@ WebHandler Language="C#" Class="RssHyperLinkFromCustomClass" %>
 
using System;
using System.Collections.Generic;
using System.Web;
using RssToolkit.Rss;
 
public class RssHyperLinkFromCustomClass: Sample5HttpHandlerBase
{
    protected override void PopulateRss(string rssName, string userName)
    {
        Rss.Channel = new Sample5Channel();
        
        Rss.Channel.Items = new List<Sample5Item>();
        if (!string.IsNullOrEmpty(rssName))
        {
            Rss.Channel.Title += " '" + rssName + "'";
        }
 
        if (!string.IsNullOrEmpty(userName))
        {
            Rss.Channel.Title += " (generated for " + userName + ")";
        }
 
        Rss.Channel.Link = "~/scenario6.aspx";
        Rss.Channel.Description = "Channel For Scenario6 in ASP.NET RSS Toolkit samples.";
        Rss.Channel.Ttl = "10";
        Rss.Channel.User = userName;
 
        Sample5Item item = new Sample5Item();
        item.Title = "CodeGeneratedClass";
        item.Description = "Consuming RSS feed programmatically using strongly typed classes";
        item.Link = "~/CodeGeneratedClass.aspx";
        Rss.Channel.Items.Add(item);
 
        item = new Sample5Item();
        item.Title = "ObjectDataSource";
        item.Description = "Consuming RSS feed using ObjectDataSource";
        item.Link = "~/ObjectDataSource.aspx";
        Rss.Channel.Items.Add(item);
    }    
}

When you navigate to this handler, the document (in RSS format) would look like this:

UPDATED WIKI: Publishing a feed using ASHX handler

IDisposable — Sat, 16 Jun 2007 05:02:17 GMT

Using an ASHX handler to publish a feed

When using the ASP.Net Build Provider mechanism, the RssToolkit will automatically detect certain files created or modified in the filesystem. It automatically generates strong-typed classes for those files and compiles the code. This occurs for any files with the extension configured in the web.confg file (typically .rss and .rssdl). This class library is used to consume a feed as documented in Consuming Feeds with a Build Provider. In addition, the RssToolkit also generates an HttpHandler derived class which you can use as a base-class from which you can then inherit from to create code that publishes your feed.
In the samples provided. The App_Code{{ folder has {{Sample5.Rss file that defines a custom feed's contents.

<?xml version="1.0" encoding="utf-8"?>
<rss version="2.0">
    <channel>
        <title>Sample Channel</title>
        <link>~/RssHyperlinkFromCustomClass.aspx</link>
        <description>Channel For Scenario5 in ASP.NET RSS Toolkit samples.</description>
        <ttl>10</ttl>
        <name></name>
        <user></user>
        <pubDate>Tue, 10 Apr 2007 23:01:10 GMT</pubDate>
        <lastBuildDate>Tue, 10 Apr 2007 23:01:10 GMT</lastBuildDate>
        <webMaster>webmaster@email.com</webMaster>
        <item>
            <title></title>
            <description></description>
            <link></link>
        </item>
        <item>
            <title></title>
            <description></description>
            <link></link>
        </item>
    </channel>
</rss>

When the file is created or modified RssToolkit's Build Provider automatically generates code and compiles it based on the schema of this file. It prefixes all the generated classes with Sample5. So like the weak-typed RssDocument there will be a parallel Sample5Rss class; RssChannel will have a parallel Sample5Channel class; and RssItem will have a parallel Sample5Item class. The classes can be used to build up the contents of the feed in a strong-typed way from whatever datasource defines the feed contents. Indeed, the feed contents could be loaded from any compliant place, including a file or a fetch from a foreign URL that the client cannot access.
The Build Provider also creates a default HttpHandler derived class called Sample5HtppHandlerBase which inherits from RssHttpHandlerBase. You can then create a custom .ashx HttpHandler which inherits from the Sample5HttpHandlerBase class and in the code-behind for that page you simply build up the contents of the feed.

<%@ WebHandler Language="C#" Class="RssHyperLinkFromCustomClass" %>
 
using System;
using System.Collections.Generic;
using System.Web;
using RssToolkit.Rss;
 
public class RssHyperLinkFromCustomClass: Sample5HttpHandlerBase
{
    protected override void PopulateRss(string rssName, string userName)
    {
        Rss.Channel = new Sample5Channel();
        
        Rss.Channel.Items = new List<Sample5Item>();
        if (!string.IsNullOrEmpty(rssName))
        {
            Rss.Channel.Title += " '" + rssName + "'";
        }
 
        if (!string.IsNullOrEmpty(userName))
        {
            Rss.Channel.Title += " (generated for " + userName + ")";
        }
 
        Rss.Channel.Link = "~/scenario6.aspx";
        Rss.Channel.Description = "Channel For Scenario6 in ASP.NET RSS Toolkit samples.";
        Rss.Channel.Ttl = "10";
        Rss.Channel.User = userName;
 
        Sample5Item item = new Sample5Item();
        item.Title = "CodeGeneratedClass";
        item.Description = "Consuming RSS feed programmatically using strongly typed classes";
        item.Link = "~/CodeGeneratedClass.aspx";
        Rss.Channel.Items.Add(item);
 
        item = new Sample5Item();
        item.Title = "ObjectDataSource";
        item.Description = "Consuming RSS feed using ObjectDataSource";
        item.Link = "~/ObjectDataSource.aspx";
        Rss.Channel.Items.Add(item);
    }    
}

When you navigate to this handler, the document (in RSS format) would look like this:
Cannot resolve link: [image:CustomRssInBrowser.png]

UPDATED WIKI: Publishing feed link with RssHyperLink

IDisposable — Sat, 16 Jun 2007 04:42:44 GMT

The RssHyperLink control

This control lets you emit an HTML <link> suitable for inclusion in the <head> element of a page. When this is done, you enable autodiscovery of feeds related to the page as well as easy subscription. When a browser link Internet Explorer 7 discovers a link like this, it will show the presence to the user with this icon on the toolbar.
The emitted link looks like this:

<link rel="alternate" type="application/rss+xml" title="Rss" href="~/RssHyperLink.ashx" />

You can use RssHyperLink to point to where the feed is provided like this:

<head>
   <title>Sample page with autodiscovery links</title>
   <art:RssHyperLink ID="myRss" runat="server" IncludeUserName="True" NavigateUrl="~/RssHyperLinkFromCustomClass.ashx">RSS</art:RssHyperLink>
   <art:RssHyperLink ID="myAtom" runat="server" IncludeUserName="True" NavigateUrl="~/RssHyperLinkFromCustomClass.ashx?outputtype=atom">Atom</art:RssHyperLink>
<head>

Notice that you can have as many links as you like in a single page, each can point to a different feed, or a different format for the same feed.
The RssHyperLink control has the following attributes in addition to those inherited from the standard Hyperlink control:

ChannelName – Will be automatically appended to the query-string of the NavigateUrl to indicate a specific channel of a feed. The query-string parameter will look like this ?c=XXX where XXX is the ChannelName value.
IncludeUserName – If true, this will append an authentication ticket representation to the query-string of the NavigateUrl to pass a FormsAuthenticationTicket along with the feed request. This allows a previously authenticated user to fetch a secured feed. The query-string parameter will look like this ?t=YYY where YYY is the Encrypted, Base64 encoded version of a FormsAuthenticationTicket.

When setting the IncludeUserName attribute true, this does NOT require a cookie, nor does this actually re-login the user. It merely passes the information necessary to (in code) handle the secure passing of the username when the feed is requested. The RssHttpHandlerBase class uses this to automatically pass the user name on to the feed population.

UPDATED WIKI: Publishing feed link with RssHyperLink

IDisposable — Sat, 16 Jun 2007 04:21:01 GMT

The RssHyperLink control

<link rel="alternate" type="application/rss+xml" title="Rss" href="~/RssHyperLink.ashx" />

You can use RssHyperLink to point to where the feed is provided like this:

<art:RssHyperLink ID="myRss" runat="server" IncludeUserName="True" NavigateUrl="~/RssHyperLinkFromCustomClass.ashx">RSS</art:RssHyperLink>
<art:RssHyperLink ID="myAtom" runat="server" IncludeUserName="True" NavigateUrl="~/RssHyperLinkFromCustomClass.ashx?outputtype=atom">Atom</art:RssHyperLink>

UPDATED WIKI: Producing Feeds

IDisposable — Sat, 16 Jun 2007 04:09:54 GMT

Publishing feeds with the RssToolkit

To publish feeds, you need to do two things. Firstly, you have indicate that you offer an feed to allow autodiscovery and subscription. Secondly, you need to construct an RssDocument class instance that contains the elements you wish to publish and make that feed available on a page.

Publishing links to your feed

The RssHyperLink control is a WebControl that can be embedded on any .aspx page for publishing links to your feed. You point the the control to the feed location and it automatically generates a link tag suitable for inclusion in the <HEAD> block of an HTML page.
How-to: Publishing feed link with RssHyperLink

Publishing the feed

You can publish the contents of your feed in several ways. You can embed the feed in a standard .aspx page, you can emit the feed from an .ashx handler, or you emit the feed as a file that can be statically accessed. In addition, the feed can be published as an RSS, Atom, or RDF document.

Using the RssHttpHandlerBase class

When you generate a custom feed class using the RssDl.exe command-line compiler or the RssBuildProvider, it automatically includes a base class that can be used to generate feeds from strong-typed Items defined by the feed. The base class is an HttpProvider and can be used in the code behind of an .ashx HttpHandler page.
How-to: Publishing a feed using ASHX handler

Using the RssDocument class

UPDATED WIKI: Producing Feeds

IDisposable — Sat, 16 Jun 2007 04:09:11 GMT

Publishing feeds with the RssToolkit

Publishing links to your feed

Publishing the feed

Using the RssHttpHandlerBase class

Using the RssDocument class

If you generate a custom feed class, or use the weak-typed RssDocument base class, you can emit the feed as an XML document (String) which can be included in any page's contents. You could also use the string to write directly to a file or embed a feed's contents in a database or email message.
How-to: Publishing a feed using ToXML

The {{Rss

<link rel="alternate" type="application/rss+xml" title="Rss" href="~/RssHyperLink.ashx" />

This tag enables Feed Autodiscovery in browsers. It enables the in IE and FireFox. To publish the feeds using RssToolkit, you can use one of the mechanisms below –

UPDATED WIKI: OPML Support

IDisposable — Sat, 16 Jun 2007 03:43:22 GMT

OPML (Outline Processor Markup Language) Support

The RssToolkit also has support for OPML feeds http://www.opml.org/spec which allows you to list a number of feeds (referred to as Outlines) that can then be individually referenced or aggregated. When used with the RssToolkit, an OPML file (or feed URL) will cause each referenced feel to be be fetched and processed and the resulting items merged into (at this time) chronological order. This allows you to create an OPML file (or feed) that looks something like this:

<?xml version="1.0" encoding="iso-8859-1"?>
<opml version="1.1">
  <head>
    <title>List of Feeds News Feeds</title>
    <dateCreated>Tue, 11 Nov 2003 19:47:24 GMT</dateCreated>
    <dateModified>Tue, 11 Nov 2003 19:47:28 GMT</dateModified>
    <ownerName>Webmaster</ownerName>
    <ownerEmail>owner@msdn.com</ownerEmail>
    <expansionState></expansionState>
    <vertScrollState>3</vertScrollState>
    <windowTop>93</windowTop>
    <windowLeft>127</windowLeft>
    <windowBottom>585</windowBottom>
    <windowRight>710</windowRight>
  </head>
  <body>
    <outline text='BBC News’ 
                 description='Updated every minute of every day - FOR PERSONAL USE ONLY'
                 htmlUrl='http://news.bbc.co.uk/go/click/rss/0.91/public/-/1/hi/default.stm'
                 language='unknown' title='BBC News' type='rss' version='RSS'
                 xmlUrl='http://news.bbc.co.uk/rss/newsonline_uk_edition/front_page/rss091.xml'/>
    <outline text='CNET News.com'
                 description='Tech news and business reports by CNET News.com. Focused on information technology, core topics include computers, hardware, software, networking, and Internet media.'
                 htmlUrl='http://news.com.com/'
                 language='unknown' title='CNET News.com' type='rss' version='RSS2'
                 xmlUrl='http://news.com.com/2547-1_3-0-5.xml'/>
  </body>
</opml>

Which will result in a single generated feed that aggregates the contents of the two feeds mentioned into a single feed. If you are using the base RssDocument class, you can access all of the items using the standard Items property and the OPML feed (or file) can be loaded using any of the standard Load overrides as shown in the Using RssDocument class section of the Consuming Feeds documenation.

UPDATED WIKI: Home

IDisposable — Sat, 16 Jun 2007 03:29:18 GMT

ASP.NET RSS Toolkit gives ASP.NET applications the ability to consume and publish to RSS feeds.

Features include:

RssDataSource control to consume feeds in ASP.NET applications

Works with ASP.NET data bound controls
Implements schema to generate columns at design time
Supports auto-generation of columns at runtime (via ICustomTypeDescriptor implementation)

Caching of downloaded feeds both in-memory and on-disk (persisted across process restarts)
Generation of strongly typed classes for feeds (including strongly typed channel, items, image, handler) based on a feed URL (the toolkit recognizes RSS, Atom and RDF feeds) or a file containing a sample feed. Allows programmatically download (and creation) of feeds using strongly-typed classes.

The toolkit includes:

Consuming feeds, using:

Stand-alone command line feed compiler that generates VB.Net or C# code files.
Build provider for .rssdl file (containing the list of feed URI(s) [including local files])
Build provider for .rss file (containing feed XML in RSS/Atom/RDF or OPML format)

Support for generation of feeds in ASP.NET application including:

RSS HTTP handler (strongly typed HTTP handlers are generated automatically by the build providers) to generate the feed.
RSS Hyper Link control (that can point to RSS HTTP handler) to create RSS links
Optional secure encoding of user name into query string to allow generation of personalized feeds

Set of classes for programmatic consumption and generation of RSS feed in a late-bound way, without using strongly types generated classes

How-to(s):

Consuming feeds: Consuming Feeds
Producing feeds: Producing Feeds
Feed aggregation: OPML Support
Feed caching: Feed Cache

Packaging

The toolkit is packaged as an assembly (DLL) that can be either placed in GAC or in ‘bin’ directory of a web site application. It is also usable from client (including WinForms) applications.
RSS Toolkit works in Medium Trust (RssToolkit.dll Assembly either in GAC or in ‘bin’) with the following caveats:

If the ASP.NET application consumes RSS feeds, the trust level must be configured to allow outbound HTTP requests.
To take advantage of disk caching, there must be a directory (configurable via AppSettings["rssTempDir"]) where the trust level policy would allow write access. However, disk caching is optional.

History

6/15/2007 New Release (version 2.0.0.0)

Huge revamp of the project by Piyush Shah http://blogs.msdn.com/shahpiyush/default.aspx to support strong-type feed generation. Added support for Atom, RDF. Added OPML aggregation, and schema validation of OMPL sub-feeds. Added ability to serve out feeds as RSS, Atom, RDF or OPML. Now supports qualified namespaces and enclosures. Download manager now can cache to application relative paths (like the App_Data directory of a web site) to aid in medium trust deployments. Added unit tests via Visual Studio Team Foundation test framework.

3/26/2006 Update (version 1.0.0.1)

Added MaxItems property to RssDataSource to limit the number of items returned.
Added automatic generation of <link> tags from RssHyperLink control, to light up the RSS toolbar icon in IE7. For more information please see http://blogs.msdn.com/rssteam/articles/PublishersGuide.aspx
Added protected Context property (of type HttpContext) to RssHttpHandlerBase class, to allow access to the HTTP request while generating a feed.
Added generation of LoadChannel(string url) method in RssCodeGenerator so that one strongly typed channel class can be used to consume different channels.
Fixed problem expanding app relative (~/…) links containing query string when generating RSS feeds.

Origins

The ASP.NET RSS Toolkit was conceived and created by Dmitry Robsman http://blogs.msdn.com/dmitryr/ and posted here by permission. Original blog postings:
Release 1.0.0.0 http://blogs.msdn.com/dmitryr/archive/2006/02/21/536552.aspx
Release 1.0.0.1 http://blogs.msdn.com/dmitryr/archive/2006/03/26/561200.aspx

UPDATED WIKI: Home

IDisposable — Sat, 16 Jun 2007 03:20:44 GMT

ASP.NET RSS Toolkit gives ASP.NET applications the ability to consume and publish to RSS feeds.

Features include:

RssDataSource control to consume feeds in ASP.NET applications

Works with ASP.NET data bound controls
Implements schema to generate columns at design time
Supports auto-generation of columns at runtime (via ICustomTypeDescriptor implementation)

Caching of downloaded feeds both in-memory and on-disk (persisted across process restarts)
Generation of strongly typed classes for feeds (including strongly typed channel, items, image, handler) based on a feed URL (the toolkit recognizes RSS, Atom and RDF feeds) or a file containing a sample feed. Allows programmatically download (and creation) of feeds using strongly-typed classes.

The toolkit includes:

Consuming feeds, using:

Stand-alone command line feed compiler that generates VB.Net or C# code files.
Build provider for .rssdl file (containing the list of feed URI(s) [including local files])
Build provider for .rss file (containing feed XML in RSS/Atom/RDF or OPML format)

Support for generation of feeds in ASP.NET application including:

RSS HTTP handler (strongly typed HTTP handlers are generated automatically by the build providers) to generate the feed.
RSS Hyper Link control (that can point to RSS HTTP handler) to create RSS links
Optional secure encoding of user name into query string to allow generation of personalized feeds

Set of classes for programmatic consumption and generation of RSS feed in a late-bound way, without using strongly types generated classes

How-to(s):

Consuming feeds: Consuming Feeds
Producing feeds: Producing Feeds
Feed aggregation: OPML Support
Feed caching: Feed Cache

Packaging

If the ASP.NET application consumes RSS feeds, the trust level must be configured to allow outbound HTTP requests.
To take advantage of disk caching, there must be a directory (configurable via AppSettings["rssTempDir"]) where the trust level policy would allow write access. However, disk caching is optional.

History

6/15/2007 New Release (version 2.0.0.0)
Huge revamp of the project by Piyush Shah http://blogs.msdn.com/shahpiyush/default.aspx to support strong-type feed generation. Added support for Atom, RDF. Added OPML aggregation, and schema validation of OMPL sub-feeds. Added ability to serve out feeds as RSS, Atom, RDF or OPML. Now supports qualified namespaces and enclosures. Download manager now can cache to application relative paths (like the App_Data directory of a web site) to aid in medium trust deployments. Added unit tests via Visual Studio Team Foundation test framework.
3/26/2006 Update (version 1.0.0.1)

Added MaxItems property to RssDataSource to limit the number of items returned.
Added automatic generation of <link> tags from RssHyperLink control, to light up the RSS toolbar icon in IE7. For more information please see http://blogs.msdn.com/rssteam/articles/PublishersGuide.aspx
Added protected Context property (of type HttpContext) to RssHttpHandlerBase class, to allow access to the HTTP request while generating a feed.
Added generation of LoadChannel(string url) method in RssCodeGenerator so that one strongly typed channel class can be used to consume different channels.
Fixed problem expanding app relative (~/…) links containing query string when generating RSS feeds.

Origins

UPDATED WIKI: Home

IDisposable — Fri, 15 Jun 2007 23:45:42 GMT

ASP.NET RSS Toolkit gives ASP.NET applications the ability to consume and publish to RSS feeds.

Features include:

RssDataSource control to consume feeds in ASP.NET applications

Works with ASP.NET data bound controls
Implements schema to generate columns at design time
Supports auto-generation of columns at runtime (via ICustomTypeDescriptor implementation)

Caching of downloaded feeds both in-memory and on-disk (persisted across process restarts)
Generation of strongly typed classes for feeds (including strongly typed channel, items, image, handler) based on a feed URL (the toolkit recognizes RSS, Atom and RDF feeds) or a file containing a sample feed. Allows programmatically download (and creation) of feeds using strongly-typed classes.

The toolkit includes:

Consuming feeds, using:

Stand-alone command line feed compiler that generates VB.Net or C# code files.
Build provider for .rssdl file (containing the list of feed URI(s) [including local files])
Build provider for .rss file (containing feed XML in RSS/Atom/RDF or OPML format)

Support for generation of feeds in ASP.NET application including:

RSS HTTP handler (strongly typed HTTP handlers are generated automatically by the build providers) to generate the feed.
RSS Hyper Link control (that can point to RSS HTTP handler) to create RSS links
Optional secure encoding of user name into query string to allow generation of personalized feeds

Set of classes for programmatic consumption and generation of RSS feed in a late-bound way, without using strongly types generated classes

How-to(s):

Consuming feeds: Consuming Feeds
Producing feeds: Producing Feeds
Feed aggregation: OPML Support
Feed caching: Feed Cache

Packaging

If the ASP.NET application consumes RSS feeds, the trust level must be configured to allow outbound HTTP requests.
To take advantage of disk caching, there must be a directory (configurable via AppSettings["rssTempDir"]) where the trust level policy would allow write access. However, disk caching is optional.

History

6/15/2007 New Rease (version 2.0.0.0)
Huge revamp of the project by Piyush Shah http://blogs.msdn.com/shahpiyush/default.aspx to support strong-type feed generation. Added support for Atom, RDF. Added OPML aggregation, and schema validation of OMPL sub-feeds. Added ability to serve out feeds as RSS, Atom, RDF or OPML. Now supports qualified namespaces and enclosures. Download manager now can cache to application relative paths (like the App_Data directory of a web site) to aid in medium trust deployments. Added unit tests via Visual Studio Team Foundation test framework.
3/26/2006 Update (version 1.0.0.1)

Added MaxItems property to RssDataSource to limit the number of items returned.
Added automatic generation of <link> tags from RssHyperLink control, to light up the RSS toolbar icon in IE7. For more information please see http://blogs.msdn.com/rssteam/articles/PublishersGuide.aspx
Added protected Context property (of type HttpContext) to RssHttpHandlerBase class, to allow access to the HTTP request while generating a feed.
Added generation of LoadChannel(string url) method in RssCodeGenerator so that one strongly typed channel class can be used to consume different channels.
Fixed problem expanding app relative (~/…) links containing query string when generating RSS feeds.