SyndicationItem.Categories Property

Definition

Namespace:

System.ServiceModel.Syndication

Assembly:

System.ServiceModel.Syndication.dll

Package:

System.ServiceModel.Syndication v9.0.0-rc.2.24473.5

Source:

SyndicationItem.cs

Gets the syndication categories for the syndication item.

public:
 property System::Collections::ObjectModel::Collection<System::ServiceModel::Syndication::SyndicationCategory ^> ^ Categories { System::Collections::ObjectModel::Collection<System::ServiceModel::Syndication::SyndicationCategory ^> ^ get(); };

public System.Collections.ObjectModel.Collection<System.ServiceModel.Syndication.SyndicationCategory> Categories { get; }

member this.Categories : System.Collections.ObjectModel.Collection<System.ServiceModel.Syndication.SyndicationCategory>

Public ReadOnly Property Categories As Collection(Of SyndicationCategory)

Property Value

Collection<SyndicationCategory>

A collection of SyndicationCategory objects that represent the categories of the syndication item.

Examples

The following code shows how to add a category to the Categories collection of a SyndicationItem.

SyndicationItem item = new SyndicationItem("Item Title", "Item Content", new Uri("http://Item/Alternate/Link"));
item.Categories.Add(new SyndicationCategory("MyFeedCategory"));

Dim item As New SyndicationItem("Item Title", "Item Content", New Uri("http:' Item/Alternate/Link"))
item.Categories.Add(New SyndicationCategory("MyFeedCategory"))

The following XML shows how a SyndicationItem instance with a category is serialized to Atom 1.0.

<entry>
  <id>Item ID</id>
  <title type="text">My Item</title>
  <updated>2007-03-16T23:02:54Z</updated>
  <author>
    <name>Jesper Aaberg</name>
    <uri>http://contoso/Jesper</uri>
    <email>jesper@contoso.com</email>
  </author>
  <link rel="alternate" href="http://someserver/MyItem" />
  <link rel="alternate" type="text/html" title="Alternate Link" length="1000" href="http://otherserver/Item" />
  <category term="Category One" />
  <content type="text">This is some content</content>
</entry>

The following XML shows how a SyndicationItem instance with a category is serialized to RSS 2.0.

<item>
  <guid isPermaLink="false">Item ID</guid>
  <link>http://someserver/MyItem</link>
  <author>lene@contoso.com</author>
  <category>Category One</category>
  <title>My Item</title>

  <description>This is some content</description>
  <a10:link rel="alternate" type="text/html" title="Alternate Link" length="1000" href="http://otherserver/Item" />
  <a10:updated>2007-03-16T23:02:54Z</a10:updated>
</item>

Remarks

When serialized to Atom 1.0 or RSS 2.0, a <category> element is created for each category in the Categories collection.