Comment le modèle objet Syndication WCF est mappé à Atom et RSS

Article
09/12/2008

Lorsque vous développez un service de syndication Windows Communication Foundation (WCF), vous créez des flux et des éléments à l'aide des classes suivantes :

Un SyndicationFeed peut être sérialisé dans n'importe quel format de syndication pour lequel un formateur est défini. WCF est fourni avec deux formateurs : Atom10FeedFormatter et Rss20FeedFormatter.

Le modèle objet autour de SyndicationFeed et SyndicationItem est aligné plus étroitement avec la spécification Atom 1.0 que la spécification RSS 2.0. En effet, Atom 1.0 est une spécification plus substantielle qui définit des éléments qui sont ambigus ou omis de la spécification RSS 2.0. De ce fait, de nombreux éléments dans le modèle objet de syndication WCF n'ont aucune représentation directe dans la spécification RSS 2.0. Lors de la sérialisation des objets SyndicationFeed et SyndicationItem dans RSS 2.0, WCF vous permet de sérialiser des éléments de données spécifiques à Atom sous la forme d'éléments d'extension qualifiés par un espace de noms qui se conforment à la spécification Atom. Vous pouvez contrôler cette opération avec un paramètre passé au constructeur Rss20FeedFormatter.

Les exemples de code dans cette rubrique utilisent une des deux méthodes définies dans cette section pour effectuer la sérialisation à proprement dite.

SerializeFeed sérialise un flux de syndication.

SerializeItem sérialise un élément de syndication.

SyndicationFeed

L'exemple de code suivant montre comment sérialiser la classe SyndicationFeed vers Atom 1.0 et RSS 2.0.

Le code XML suivant montre comment SyndicationFeed est sérialisé vers Atom 1.0.

<?xml version="1.0" encoding="utf-8"?>
<feed xml:lang="EN-US" xmlns="http://www.w3.org/2005/Atom">
  <title type="text">My Feed Title</title>
  <subtitle type="text">My Feed Description</subtitle>
  <id>FeedID</id>
  <rights type="text">Copyright 2007</rights>
  <updated>2007-08-29T13:57:17-07:00</updated>
  <category term="categoryName" label="categoryLabel" scheme="categoryScheme" />
  <logo>https://server/image.jpg</logo>
  <generator>Sample Code</generator>
  <link rel="alternate" href="http://myfeeduri/" />
  <entry>
    <id>ItemID</id>
    <title type="text">Item Title</title>
    <summary type="text">Item Summary</summary>
    <published>2007-08-29T00:00:00-07:00</published>
    <updated>2007-08-29T13:57:17-07:00</updated>
    <author>
      <name>Jesper Aaberg</name>
      <uri>http://Jesper/Aaberg</uri>
      <email>Jesper@Aaberg.com</email>
    </author>
    <contributor>
      <name>Lene Aaling</name>
      <uri>http://Lene/Aaling</uri>
      <email>Lene@Aaling.com</email>
    </contributor>
    <link rel="alternate" href="http://myitemuri/" />
    <category term="categoryName" label="categoryLabel" scheme="categoryScheme" />
    <content type="text">Item Content</content>
    <rights type="text">Copyright 2007</rights>
    <source>
      <title type="text">My Feed Title</title>
      <subtitle type="text">My Feed Description</subtitle>
      <id>FeedID</id>
      <rights type="text">Copyright 2007</rights>
      <updated>2007-08-29T13:57:17-07:00</updated>
      <category term="categoryName" label="categoryLabel" scheme="categoryScheme" />
      <logo>https://server/image.jpg</logo>
      <generator>Sample Code</generator>
      <link rel="alternate" href="http://myfeeduri/" />
    </source>
  </entry>
</feed>

Le code XML suivant montre comment SyndicationFeed est sérialisé vers RSS 2.0.

<?xml version="1.0" encoding="utf-8"?>
<rss xmlns:a10="http://www.w3.org/2005/Atom" version="2.0">
  <channel>
    <title>My Feed Title</title>
    <link>http://myfeeduri/</link>
    <description>My Feed Description</description>
    <language>EN-US</language>
    <copyright>Copyright 2007</copyright>
    <lastBuildDate>Wed, 29 Aug 2007 13:57:17 -0700</lastBuildDate>
    <category domain="categoryScheme">categoryName</category>
    <generator>Sample Code</generator>
    <image>
      <url>https://server/image.jpg</url>
      <title>My Feed Title</title>
      <link>http://myfeeduri/</link>
    </image>
    <a10:id>FeedID</a10:id>
    <item>
      <guid isPermaLink="false">ItemID</guid>
      <link>http://myitemuri/</link>
      <author>Jesper@Aaberg.com</author>
      <category domain="categoryScheme">categoryName</category>
      <title>Item Title</title>
      <description>Item Summary</description>
      <source>My Feed Title</source>
      <pubDate>Wed, 29 Aug 2007 00:00:00 -0700</pubDate>
      <a10:updated>2007-08-29T13:57:17-07:00</a10:updated>
      <a10:rights type="text">Copyright 2007</a10:rights>
      <a10:content type="text">Item Content</a10:content>
      <a10:contributor>
        <a10:name>Lene Aaling</a10:name>
        <a10:uri>http://Lene/Aaling</a10:uri>
        <a10:email>Lene@Aaling.com</a10:email>
      </a10:contributor>
    </item>
  </channel>
</rss>

SyndicationItem

L'exemple de code suivant montre comment sérialiser la classe SyndicationItem vers Atom 1.0 et RSS 2.0.

Le code XML suivant montre comment SyndicationItem est sérialisé vers Atom 1.0.

<entry xmlns="http://www.w3.org/2005/Atom">
  <id>ItemID</id>
  <title type="text">Item Title</title>
  <summary type="text">Item Summary</summary>
  <published>2007-08-29T00:00:00-07:00</published>
  <updated>2007-08-29T14:07:09-07:00</updated>
  <author>
    <name>Jesper Aaberg</name>
    <uri>http://Contoso/Aaberg</uri>
    <email>Jesper.Aaberg@contoso.com</email>
  </author>
  <author>
    <name>Syed Abbas</name>
    <uri>http://Contoso/Abbas</uri>
    <email>Syed.Abbas@contoso.com</email>
  </author>
  <contributor>
    <name>Lene Aaling</name>
    <uri>http://Contoso/Aaling</uri>
    <email>Lene.Aaling@contoso.com</email>
  </contributor>
  <contributor>
    <name>Kim Abercrombie</name>
    <uri>http://Contoso/Abercrombie</uri>
    <email>Kim.Abercrombie@contoso.com</email>
  </contributor>
  <link rel="alternate" href="http://myitemuri/" />
  <category term="categoryName" label="categoryLabel" scheme="categoryScheme" />
  <category term="categoryName" label="categoryLabel" scheme="categoryScheme" />
  <content type="text">Item Content</content>
  <rights type="text">Copyright 2007</rights>
  <source>
    <title type="text">My Feed Title</title>
    <subtitle type="text">My Feed Description</subtitle>
    <link rel="alternate" href="http://myfeeduri/" />
  </source>
</entry>

Le code XML suivant montre comment SyndicationItem est sérialisé vers RSS 2.0.

<item>
  <guid isPermaLink="false">ItemID</guid>
  <link>http://myitemuri/</link>
  <author xmlns="http://www.w3.org/2005/Atom">
    <name>Jesper Aaberg</name>
    <uri>http://Jesper/Aaberg</uri>
    <email>Jesper@Aaberg.com</email>
  </author>
  <author xmlns="http://www.w3.org/2005/Atom">
    <name>Syed Abbas</name>
    <uri>http://Contoso/Abbas</uri>
    <email>Syed.Abbas@contoso.com</email>
  </author>
  <category domain="categoryScheme">categoryName</category>
  <category domain="categoryScheme">categoryName</category>
  <title>Item Title</title>
  <description>Item Summary</description>
  <source>My Feed Title</source>
  <pubDate>Wed, 29 Aug 2007 00:00:00 -0700</pubDate>
  <updated xmlns="http://www.w3.org/2005/Atom">2007-08-29T14:07:09-07:00</updated>
  <rights type="text" xmlns="http://www.w3.org/2005/Atom">Copyright 2007</rights>
  <content type="text" xmlns="http://www.w3.org/2005/Atom">Item Content</content>
  <contributor xmlns="http://www.w3.org/2005/Atom">
    <name>Lene Aaling</name>
    <uri>http://Contoso/Aaling</uri>
    <email>Lene.Aaling@contoso.com</email>
  </contributor>
  <contributor xmlns="http://www.w3.org/2005/Atom">
    <name>Kim Abercrombie</name>
    <uri>http://Contoso/Abercrombie</uri>
    <email>Kim.Abercrombie@contoso.com</email>
  </contributor>
</item>

SyndicationPerson

L'exemple de code suivant montre comment sérialiser la classe SyndicationPerson vers Atom 1.0 et RSS 2.0.

Le code XML suivant montre comment SyndicationPerson est sérialisé vers Atom 1.0.

  <author>
    <name>Jesper Aaberg</name>
    <uri>http://Contoso/Aaberg</uri>
    <email>Jesper.Aaberg@contoso.com</email>
  </author>
<contributor>
    <name>Lene Aaling</name>
    <uri>http://Contoso/Aaling</uri>
    <email>Lene.Aaling@contoso.com</email>
  </contributor>

Le code XML suivant montre comment la classe SyndicationPerson est sérialisée vers RSS 2.0 si une seule SyndicationPerson existe dans les collections Authors ou Contributors, respectivement.

<author>Jesper.Aaberg@contoso.com</author>
<a10:contributor>
    <a10:name>Lene Aaling</a10:name>
    <a10:uri>http://Contoso/Aaling</a10:uri>
    <a10:email>Lene.Aaling@contoso.com</a10:email>
</a10:contributor>

Le code XML suivant montre comment la classe SyndicationPerson est sérialisée vers RSS 2.0 si plusieurs SyndicationPerson existent dans les collections Authors ou Contributors, respectivement.

<a10:author>
    <a10:name>Jesper Aaberg</a10:name>
    <a10:uri>http://Contoso/Aaberg</a10:uri>
    <a10:email>Jesper.Aaberg@contoso.com</a10:email>
</a10:author>
<a10:author>
    <a10:name>Syed Abbas</a10:name>
    <a10:uri>http://Contoso/Abbas</a10:uri>
    <a10:email>Syed.Abbas@contoso.com</a10:email>
</a10:author>
<a10:contributor>
    <a10:name>Lene Aaling</a10:name>
    <a10:uri>http://Contoso/Aaling</a10:uri>
    <a10:email>Lene.Aaling@contoso.com</a10:email>
</a10:contributor>
<a10:contributor>
    <a10:name>Kim Abercrombie</a10:name>
    <a10:uri>http://Contoso/Abercrombie</a10:uri>
    <a10:email>Kim.Abercrombie@contoso.com</a10:email>
</a10:contributor>

SyndicationLink

L'exemple de code suivant montre comment sérialiser la classe SyndicationLink vers Atom 1.0 et RSS 2.0.

Le code XML suivant montre comment SyndicationLink est sérialisé vers Atom 1.0.

<link rel="alternate" type="text/html" title="My Link Title" length="2048" href="http://contoso/MyLink" />

Le code XML suivant montre comment SyndicationLink est sérialisé vers RSS 2.0.

<a10:link rel="alternate" type="text/html" title="My Link Title" length="2048" href="http://contoso/MyLink" />

SyndicationCategory

L'exemple de code suivant montre comment sérialiser la classe SyndicationCategory vers Atom 1.0 et RSS 2.0.

Le code XML suivant montre comment SyndicationCategory est sérialisé vers Atom 1.0.

<category term="categoryName" label="categoryLabel" scheme="categoryScheme" />

Le code XML suivant montre comment SyndicationCategory est sérialisé vers RSS 2.0.

<category domain="categoryScheme">categoryName</category>

TextSyndicationContent

L'exemple de code suivant montre comment sérialiser la classe TextSyndicationContent vers Atom 1.0 et RSS 2.0 lorsque TextSyndicationContent est créée avec un contenu HTML.

Le code XML suivant montre comment la classe TextSyndicationContent avec un contenu HTML est sérialisée vers Atom 1.0.

<content type="html"><html> some html </html></content>

Le code XML suivant montre comment la classe TextSyndicationContent avec un contenu HTML est sérialisée vers RSS 2.0.

<description><html> some html </html></description>

L'exemple de code suivant montre comment sérialiser la classe TextSyndicationContent vers Atom 1.0 et RSS 2.0 lorsque TextSyndicationContent est créée avec un contenu en texte brut.

Le code XML suivant montre comment la classe TextSyndicationContent avec un contenu de texte brut est sérialisée vers Atom 1.0.

<content type="text">Some Plain Text</content>

Le code XML suivant montre comment la classe TextSyndicationContent avec un contenu de texte brut est sérialisée vers RSS 2.0.

<description>Some Plain Text</description>

L'exemple de code suivant montre comment sérialiser la classe TextSyndicationContent vers Atom 1.0 et RSS 2.0 lorsque TextSyndicationContent est créée avec un contenu XHTML.

Le code XML suivant montre comment la classe TextSyndicationContent avec un contenu XHTML est sérialisée vers Atom 1.0.

<content type="xhtml">

<html> some xhtml </html>

</content>

Le code XML suivant montre comment la classe TextSyndicationContent avec un contenu XHTML est sérialisée vers RSS 2.0.

<description><html> some xhtml </html></description>

UrlSyndicationContent

L'exemple de code suivant montre comment sérialiser la classe UrlSyndicationContent vers Atom 1.0 et RSS 2.0.

Le code XML suivant montre comment la classe UrlSyndicationContent est sérialisée vers Atom 1.0.

<content type="audio" src="http://someurl/" />

Le code XML suivant montre comment la classe UrlSyndicationContent avec un contenu XHTML est sérialisée vers RSS 2.0.

<description />

<content type="audio" src="http://Contoso/someurl/" xmlns="http://www.w3.org/2005/Atom" />

XmlSyndicationContent

L'exemple de code suivant montre comment sérialiser la classe XmlSyndicationContent vers Atom 1.0 et RSS 2.0.

Le code XML suivant montre comment la classe XmlSyndicationContent est sérialisée vers Atom 1.0.

<content type="mytype">

<SomeData xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/FeedMapping" />

</content>

Le code XML suivant montre comment la classe XmlSyndicationContent avec un contenu XHTML est sérialisée vers RSS 2.0.

<content type="mytype" xmlns="http://www.w3.org/2005/Atom">

<SomeData xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/FeedMapping" />

</content>

Voir aussi

Tâches

Comment : créer un flux RSS de base
Comment : créer un flux Atom de base
Comment : exposer un flux en tant que flux Atom et flux RSS

Concepts

Vue d'ensemble de la syndication WCF
Architecture de syndication

Partager via

Comment le modèle objet Syndication WCF est mappé à Atom et RSS

SyndicationFeed

SyndicationItem

SyndicationPerson

SyndicationLink

SyndicationCategory

TextSyndicationContent

UrlSyndicationContent

XmlSyndicationContent

Voir aussi

Tâches

Concepts

Ressources supplémentaires