Wie das WCF-Syndication-Objektmodell Atom und RSS zugeordnet wird

Artikel
09/12/2008

Wenn Sie einen Windows Communication Foundation (WCF) Syndication-Dienst entwickeln, erstellen Sie Feeds und Elemente anhand der folgenden Klassen:

Ein SyndicationFeed kann in jedes beliebige Syndication-Format serialisiert werden, für das ein Formatierungsprogramm definiert ist. WCF wird mit zwei Formatierungsprogrammen geliefert: Atom10FeedFormatter und Rss20FeedFormatter.

Das Objektmodell um SyndicationFeed und SyndicationItem orientiert sich näher an der Atom 1.0-Spezifikation als der RSS 2.0-Spezifikation. Das liegt daran, dass Atom 1.0 eine umfassendere Spezifikation ist, die Elemente definiert, die in der RSS 2.0-Spezifikation nicht eindeutig sind oder fehlen. Aus diesem Grund verfügen viele Elemente im WCF Syndication-Objektmodell über keine direkte Darstellung in der RSS 2.0-Spezifikation. Bei der Serialisierung von SyndicationFeed-Objekten und SyndicationItem-Objekten in RSS 2.0 ermöglicht WCF es Ihnen, Atom-spezifische Datenelemente als durch Namespace gekennzeichnete Erweiterungselemente zu serialisieren, die der Atom-Spezifikation entsprechen. Sie können diesen Vorgang anhand eines Parameters steuern, der an den Rss20FeedFormatter-Konstruktor übergeben wird.

Für die Codebeispiele in diesem Thema wird eine der beiden hier definierten Methoden für die Serialisierung verwendet.

SerializeFeed serialisiert einen Syndication-Feed.

SerializeItem serialisiert ein Syndication-Element.

SyndicationFeed

Das folgende Codebeispiel zeigt, wie die SyndicationFeed-Klasse in Atom 1.0 und RSS 2.0 serialisiert wird.

Im folgenden XML wird gezeigt, wie der SyndicationFeed in Atom 1.0 serialisiert wird.

<?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>

Im folgenden XML wird gezeigt, wie der SyndicationFeed in RSS 2.0 serialisiert wird.

<?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

Das folgende Codebeispiel zeigt, wie die SyndicationItem-Klasse in Atom 1.0 und RSS 2.0 serialisiert wird.

Im folgenden XML wird gezeigt, wie das SyndicationItem in Atom 1.0 serialisiert wird.

<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>

Im folgenden XML wird gezeigt, wie das SyndicationItem in RSS 2.0 serialisiert wird.

<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

Das folgende Codebeispiel zeigt, wie die SyndicationItem-Klasse in Atom 1.0 und RSS 2.0 serialisiert wird.

Im folgenden XML wird gezeigt, wie SyndicationPerson in Atom 1.0 serialisiert wird.

  <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>

Das folgende XML zeigt, wie die SyndicationPerson-Klasse in RSS 2.0 serialisiert wird, wenn nur eine SyndicationPerson in der Authors-Auflistung bzw. der Contributors-Auflistung vorhanden ist.

<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>

Das folgende XML zeigt, wie die SyndicationPerson-Klasse in RSS 2.0 serialisiert wird, wenn mehr als eine SyndicationPerson in der Authors-Auflistung bzw. der Contributors-Auflistung vorhanden ist.

<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

Das folgende Codebeispiel zeigt, wie die SyndicationLink-Klasse in Atom 1.0 und RSS 2.0 serialisiert wird.

Im folgenden XML wird gezeigt, wie der SyndicationLink in Atom 1.0 serialisiert wird.

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

Im folgenden XML wird gezeigt, wie der SyndicationLink in RSS 2.0 serialisiert wird.

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

SyndicationCategory

Das folgende Codebeispiel zeigt, wie die SyndicationCategory-Klasse in Atom 1.0 und RSS 2.0 serialisiert wird.

Im folgenden XML wird gezeigt, wie die SyndicationCategory in Atom 1.0 serialisiert wird.

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

Im folgenden XML wird gezeigt, wie die SyndicationCategory in RSS 2.0 serialisiert wird.

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

TextSyndicationContent

Im folgenden Codebeispiel wird gezeigt, wie die TextSyndicationContent-Klasse in Atom 1.0 und RSS 2.0 serialisiert wird, wenn TextSyndicationContent mit HTML-Inhalt erstellt wird.

Das folgende XML zeigt, wie die TextSyndicationContent-Klasse mit HTML-Inhalt in Atom 1.0 serialisiert wird.

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

Das folgende XML zeigt, wie die TextSyndicationContent-Klasse mit HTML-Inhalt in RSS 2.0 serialisiert wird.

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

Im folgenden Codebeispiel wird gezeigt, wie die XmlSyndicationContent-Klasse in Atom 1.0 und RSS 2.0 serialisiert wird, wenn TextSyndicationContent mit Nur-Text-Inhalt erstellt wird.

Das folgende XML zeigt, wie die TextSyndicationContent-Klasse mit Nur-Text-Inhalt in Atom 1.0 serialisiert wird.

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

Das folgende XML zeigt, wie die TextSyndicationContent-Klasse mit Nur-Text-Inhalt in RSS 2.0 serialisiert wird.

<description>Some Plain Text</description>

Im folgenden Codebeispiel wird gezeigt, wie die TextSyndicationContent-Klasse in Atom 1.0 und RSS 2.0 serialisiert wird, wenn TextSyndicationContent mit XHTML-Inhalt erstellt wird.

Das folgende XML zeigt, wie die TextSyndicationContent-Klasse mit XHTML-Inhalt in Atom 1.0 serialisiert wird.

<content type="xhtml">

<html> some xhtml </html>

</content>

Das folgende XML zeigt, wie die TextSyndicationContent-Klasse mit XHTML-Inhalt in RSS 2.0 serialisiert wird.

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

UrlSyndicationContent

Das folgende Codebeispiel zeigt, wie die UrlSyndicationContent-Klasse in Atom 1.0 und RSS 2.0 serialisiert wird.

Das folgende XML zeigt, wie die TextSyndicationContent-Klasse in Atom 1.0 serialisiert wird.

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

Das folgende XML zeigt, wie die UrlSyndicationContent-Klasse mit XHTML-Inhalt in RSS 2.0 serialisiert wird.

<description />

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

XmlSyndicationContent

Das folgende Codebeispiel zeigt, wie die XmlSyndicationContent-Klasse in Atom 1.0 und RSS 2.0 serialisiert wird.

Das folgende XML zeigt, wie die XmlSyndicationContent-Klasse in Atom 1.0 serialisiert wird.

<content type="mytype">

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

</content>

Das folgende XML zeigt, wie die XmlSyndicationContent-Klasse mit XHTML-Inhalt in RSS 2.0 serialisiert wird.

<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>

Siehe auch

Aufgaben

Gewusst wie: Erstellen eines grundlegenden RS-Feeds
Gewusst wie: Erstellen eines grundlegenden Atom-Feeds
Gewusst wie: Einen Feed sowohl als Atom als auch als RSS verfügbar machen

Konzepte

Übersicht über WCF Syndication
Architektur von Syndication

Share via

Wie das WCF-Syndication-Objektmodell Atom und RSS zugeordnet wird

SyndicationFeed

SyndicationItem

SyndicationPerson

SyndicationLink

SyndicationCategory

TextSyndicationContent

UrlSyndicationContent

XmlSyndicationContent

Siehe auch

Aufgaben

Konzepte

Zusätzliche Ressourcen