How to consume Atom syndication feeds

Atom is an an XML-based Web content and metadata syndication format that describes lists of related information known as
feeds. Feeds are composed of a number of items, known as entries, each with an extensible set of attached metadata. An entry can also appear as the document (i.e., top-level) element of a stand-alone Atom Entry Document. The framework provides
a complete implementation of the Atom 1.0 specification, which can be found at
http://www.atomenabled.org/developers/syndication/atom-format-spec.php.

The classes and enumerations that together compose the implementation of Atom are located in the
Argotic.Syndication namespace. The primary framework entities that you will use when working with Atom formated syndication resources are the
AtomFeed and AtomEntry classes. These classes implement the ISyndicationResource and
IExtensibleSyndicationObject interfaces, and provides an API that maps closely to the syndication specification entities as well as methods for consuming and persisting syndicated content. The framework will by default automatically load any syndication
extensions that are present in addition to the syndicated content information and attempt to handle malformed XML data.

Consuming syndicated content

The AtomFeed and AtomEntry classes provides two ways of consuming syndicated content that conforms to the Atom syndication format. The first way to consume an Atom feed or Atom entry document is to use the static
Create method exposed by the AtomFeed and AtomEntry classes, which provides a means of quickly consuming web content that is available at a given
Uri:

The other way to consume an Atom feed or Atom entry document is to use the overloaded
Load method exposed by the AtomFeed and AtomEntry classes, which provides a means of consuming syndicated content from a variety of data sources such as
IXPathNavigable, Stream, XmlReader, and Uri:

Specifying the set of features to support when loading syndicated content

The framework provides a means of specifying the set of features that are supported when loading an Atom feed or Atom Entry Document via the
SyndicationResourceLoadSettings class. This class is passed as an argument to the
Create or Load methods of the AtomFeed and AtomEntry classes in order to configure how the load operation is performed.

The SyndicationResourceLoadSettings class exposes the following properties:

AutoDetectExtensions - Indicates if syndication extensions supported by the load operation are automatically determined based on the XML namespaces declared on the syndication resource.

CharacterEncoding - Indicates the character encoding to use when parsing a syndication resource.

RetrievalLimit - Determines the maximum number of resource entities to retrieve from a syndication resource.

SupportedExtensions - Indicates the custom syndication extensions that you wish to support.

Timeout - Specifies the amount of time after which asynchronous load operations will time out.

using Argotic.Common;
using Argotic.Syndication;
SyndicationResourceLoadSettings settings = new SyndicationResourceLoadSettings();
settings.RetrievalLimit = 10;
Uri feedUrl = new Uri("http://news.google.com/?output=atom");
AtomFeed feed = AtomFeed.Create(feedUrl, settings);
foreach (AtomEntry entry in feed.Entries)
{
// The entries have been limited to the first 10 in the feed
}

In the example above, we are using the SyndicationResourceLoadSettings class to limit the number of Atom feed entries that are read from the underlying XML data and added to the feed's
Entries collection. This can be useful when you are only interested in the a subset of the total available entries, are working with a very large feed, or want to reduce the time it takes to load a feed. By default the
AtomFeed class loads all entries that are present in the feed.