SyndicationFeed Klasse

Definition

Stellt ein übergeordnetes Feed-Objekt dar, <feed> in Atom 1.0 und <rss> in RSS 2.0.

public ref class SyndicationFeed
public class SyndicationFeed
type SyndicationFeed = class
Public Class SyndicationFeed
Vererbung
SyndicationFeed

Beispiele

Der folgende Code zeigt die Erstellung einer SyndicationFeed-Instanz und die Serialisierung zu Atom 1.0 und RSS 2.0.

SyndicationFeed feed = new SyndicationFeed("Feed Title", "Feed Description", new Uri("http://Feed/Alternate/Link"), "FeedID", DateTime.Now);
// Add a custom attribute.
XmlQualifiedName xqName = new XmlQualifiedName("CustomAttribute");
feed.AttributeExtensions.Add(xqName, "Value");

SyndicationPerson sp = new SyndicationPerson("jesper@contoso.com", "Jesper Aaberg", "http://Jesper/Aaberg");
feed.Authors.Add(sp);

SyndicationCategory category = new SyndicationCategory("FeedCategory", "CategoryScheme", "CategoryLabel");
feed.Categories.Add(category);

feed.Contributors.Add(new SyndicationPerson("lene@contoso.com", "Lene Aaling", "http://lene/aaling"));
feed.Copyright = new TextSyndicationContent("Copyright 2007");
feed.Description = new TextSyndicationContent("This is a sample feed");

// Add a custom element.
XmlDocument doc = new XmlDocument();
XmlElement feedElement = doc.CreateElement("CustomElement");
feedElement.InnerText = "Some text";
feed.ElementExtensions.Add(feedElement);

feed.Generator = "Sample Code";
feed.Id = "FeedID";
feed.ImageUrl = new Uri("http://server/image.jpg");

TextSyndicationContent textContent = new TextSyndicationContent("Some text content");
SyndicationItem item = new SyndicationItem("Item Title", textContent, new Uri("http://server/items"), "ItemID", DateTime.Now);

List<SyndicationItem> items = new List<SyndicationItem>();
items.Add(item);
feed.Items = items;

feed.Language = "en-us";
feed.LastUpdatedTime = DateTime.Now;

SyndicationLink link = new SyndicationLink(new Uri("http://server/link"), "alternate", "Link Title", "text/html", 1000);
feed.Links.Add(link);

XmlWriter atomWriter = XmlWriter.Create("atom.xml");
Atom10FeedFormatter atomFormatter = new Atom10FeedFormatter(feed);
atomFormatter.WriteTo(atomWriter);
atomWriter.Close();

XmlWriter rssWriter = XmlWriter.Create("rss.xml");
Rss20FeedFormatter rssFormatter = new Rss20FeedFormatter(feed);
rssFormatter.WriteTo(rssWriter);
rssWriter.Close();
Dim feed As SyndicationFeed = New SyndicationFeed("Feed Title", "Feed Description", New Uri("http:'Feed/Alternate/Link"), "FeedID", DateTime.Now)
' Add a custom attribute.
Dim xqName As XmlQualifiedName = New XmlQualifiedName("CustomAttribute")
feed.AttributeExtensions.Add(xqName, "Value")

Dim sp As SyndicationPerson = New SyndicationPerson("jesper@contoso.com", "Jesper Aaberg", "http:'jesper/aaberg")
feed.Authors.Add(sp)

Dim category As SyndicationCategory = New SyndicationCategory("FeedCategory", "CategoryScheme", "CategoryLabel")
feed.Categories.Add(category)

feed.Contributors.Add(New SyndicationPerson("Lene@contoso.com", "Lene Aaling", "http:'Lene/Aaling"))
feed.Copyright = New TextSyndicationContent("Copyright 2007")
feed.Description = New TextSyndicationContent("This is a sample feed")

' Add a custom element.
Dim doc As XmlDocument = New XmlDocument()
Dim feedElement As XmlElement = doc.CreateElement("CustomElement")
feedElement.InnerText = "Some text"
feed.ElementExtensions.Add(feedElement)

feed.Generator = "Sample Code"
feed.Id = "FeedID"
feed.ImageUrl = New Uri("http:'server/image.jpg")

Dim textContent As TextSyndicationContent = New TextSyndicationContent("Some text content")
Dim item As SyndicationItem = New SyndicationItem("Item Title", textContent, New Uri("http:'server/items"), "ItemID", DateTime.Now)

Dim items As Collection(Of SyndicationItem) = New Collection(Of SyndicationItem)()
items.Add(item)
feed.Items = items

feed.Language = "en-us"
feed.LastUpdatedTime = DateTime.Now

Dim link As SyndicationLink = New SyndicationLink(New Uri("http:'server/link"), "alternate", "Link Title", "text/html", 1000)
feed.Links.Add(link)

Dim atomWriter As XmlWriter = XmlWriter.Create("atom.xml")
Dim atomFormatter As Atom10FeedFormatter = New Atom10FeedFormatter(feed)
atomFormatter.WriteTo(atomWriter)
atomWriter.Close()

Dim rssWriter As XmlWriter = XmlWriter.Create("rss.xml")
Dim rssFormatter As Rss20FeedFormatter = New Rss20FeedFormatter(feed)
rssFormatter.WriteTo(rssWriter)
rssWriter.Close()

Im folgenden XML-Code wird gezeigt, wie ein SyndicationFeed in Atom 1.0 serialisiert wird.

<feed xml:lang="en-us" CustomAttribute="Value" xmlns="http://www.w3.org/2005/Atom">
  <title type="text">Feed Title</title>
  <subtitle type="text">This is a sample feed</subtitle>
  <id>FeedID</id>

  <rights type="text">Copyright 2007</rights>
  <updated>2007-04-13T17:29:38Z</updated>
  <category term="FeedCategory" label="CategoryLabel" scheme="CategoryScheme" />
  <logo>http://contoso/image.jpg</logo>
  <author>
    <name>Jesper Aaberg</name>
    <uri>http://contoso/Aaberg</uri>
    <email>Jesper.Asberg@contoso.com</email>
  </author>
  <contributor>
    <name>Lene Aalling</name>
    <uri>http://contoso/Aalling</uri>
    <email>Lene.Aaling@contoso.com</email>
  </contributor>
  <generator>Sample Code</generator>
  <link rel="alternate" type="text/html" title="Link Title" length="1000" href="http://contoso/link" />

  <link customAttribute="value" rel="alternate" type="text/html" title="Link Title" length="1000" href="http://contoso/link" />
  <CustomElement xmlns="">Some text</CustomElement>
  <entry>
    <id>ItemID</id>
    <title type="text">Item Title</title>
    <updated>2007-04-13T17:29:38Z</updated>
    <link rel="alternate" href="http://contoso/items" />
    <content type="text">Some text content</content>
  </entry>

</feed>

Im folgenden XML-Code wird gezeigt, wie eine SyndicationFeed-Instanz in RSS 2.0 serialisiert wird.

<rss xmlns:a10="http://www.w3.org/2005/Atom" version="2.0">
  <channel CustomAttribute="Value">
    <title>Feedtitel</title>
    <link>http://feed/Alternate/Link</link>
    <description>Dies ist ein Beispielfeed</description>
    <language>en-us</language>

    <copyright>Copyright 2007</copyright>

    <managingEditor>Jesper.Aaberg@contoso.com</managingEditor>
    <lastBuildDate>Fri, 13 Apr 2007 17:29:38 Z</lastBuildDate>
    <category domain="CategoryScheme">FeedCategory</category>
    <a10:link rel="alternate" type="text/html" title="Link Title" length="1000" href="http://contoso/link" />
    <generator>Sample Code</generator>
    
    <a10:contributor>
      <a10:name>Lene Aalling</a10:name>
      <a10:uri>http://contoso/Aalling</a10:uri>
      <a10:email>Lene.Aalling@contoso.com</a10:email>
    </a10:contributor>
    
    <a10:author>
      <a10:name>Lene Aalling</a10:name>
      <a10:uri>http://contoso/Aalling</a10:uri>
      <a10:email>Lene.Aalling@contoso.com</a10:email>
    </a10:author>
    <image>
      <url>http://contoso/image.jpg</url>
      <title>Feedtitel</title>
      <link>http://feed/Alternate/Link</link>
    </image>
    <a10:id>FeedID</a10:id>
    <a10:link customAttribute="value" rel="alternate" type="text/html" title="Link Title" length="1000" href="http://contoso/link" />
    
    <CustomElement>Some text</CustomElement>
    <item>
      <guid isPermaLink="false">ItemID</guid>
      <link>http://contoso/items</link>
      <title>Elementtitel</title>
      <description>Einige Textinhalte</description>
      <a10:updated>2007-04-13T17:29:38Z</a10:updated>
    </item>
  </channel>
</rss>

Hinweise

Wenn sie in Atom 1.0 serialisiert werden, wird eine SyndicationFeed Instanz in ein <feed> Element geschrieben. Die folgende Tabelle zeigt, wie jede in der Klasse SyndicationFeed definierte Eigenschaft in Atom 1.0 serialisiert wird.

SyndicationFeed -Eigenschaft Serialisierte Form
AttributeExtensions Ein Attribut im <feed> Element für jedes Attribut in der Auflistung.
Authors Ein <author> Element für jedes SyndicationPerson Element in der Auflistung.
Categories Ein <category> Element für jedes SyndicationCategory Element in der Auflistung.
Contributors Ein <contributor> Element für jedes SyndicationPerson Element in der Auflistung.
Copyright Ein <rights>-Element.
Description Ein <subtitle>-Element.
ElementExtensions Jedes Element in der Auflistung wird innerhalb des <feed> Elements geschrieben.
Generator Ein <generator>-Element.
Id Ein <id>-Element.
ImageUri Ein <logo>-Element.
Items Ein <entry> Element für jedes SyndicationItem Element in der Auflistung.
Language Nicht serialisiert
LastUpdatedTime Ein <updated>-Element.
Links Ein <link> Element für jedes SyndicationLink Element in der Auflistung.
Title Ein <title>-Element.

Bei der Serialisierung zu RSS 2.0 wird eine SyndicationFeed-Instanz in ein <rss>-Element geschrieben. Die folgende Tabelle zeigt, wie jede in der Klasse SyndicationFeed definierte Eigenschaft in RSS 2.0 serialisiert wird.

SyndicationFeed -Eigenschaft Serialisierte Form
AttributeExtensions Ein Attribut im <channel> Element für jedes Attribut in der Auflistung.
Authors Ein <managingEditor> Element, wenn sich nur ein SyndicationPerson Element in der Auflistung befindet; andernfalls ein <a10:author> Element für jede SyndicationPerson in der Auflistung.
Categories Ein <category> Element für jedes SyndicationCategory Element in der Auflistung.
Contributors Ein <a10:contributor> Element für jedes SyndicationPerson Element in der Auflistung.
Copyright Ein <copyright>-Element.
Description Ein <description>-Element.
ElementExtensions Jedes Element in der Auflistung wird innerhalb des <channel> Elements geschrieben.
Generator Ein <generator>-Element.
Id Ein <a10:id>-Element.
ImageUri Ein <image>-Element.
Items Ein <item> Element für jedes SyndicationItem Element in der Auflistung.
Language Ein <language>-Element.
LastUpdatedTime Ein <lastBuildDate>-Element.
Links Ein <a10:link> Element für jedes SyndicationLink Element in der Auflistung.
Title Ein <title>-Element.

Konstruktoren

SyndicationFeed()

Initialisiert eine neue Instanz der SyndicationFeed-Klasse.

SyndicationFeed(IEnumerable<SyndicationItem>)

Initialisiert eine neue Instanz der SyndicationFeed-Klasse mit der angegebenen Auflistung von SyndicationItem-Objekten.

SyndicationFeed(String, String, Uri)

Initialisiert eine neue Instanz der Klasse SyndicationFeed mit dem angegebenen Titel, der Beschreibung und der Uniform Resource Identifier (URI).

SyndicationFeed(String, String, Uri, IEnumerable<SyndicationItem>)

Initialisiert eine neue Instanz der Klasse SyndicationFeed mit dem angegebenen Titel, der Beschreibung, der URI und der Sammlung von SyndicationItem-Objekten.

SyndicationFeed(String, String, Uri, String, DateTimeOffset)

Erstellt eine neue Instanz der SyndicationFeed-Klasse.

SyndicationFeed(String, String, Uri, String, DateTimeOffset, IEnumerable<SyndicationItem>)

Erstellt eine neue Instanz der SyndicationFeed-Klasse.

SyndicationFeed(SyndicationFeed, Boolean)

Erstellt eine neue Instanz der SyndicationFeed-Klasse mit dem festgelegten Feed.

Eigenschaften

AttributeExtensions

Ruft eine Auflistung mit Attributerweiterungen ab.

Authors

Ruft eine Auflistung von Feed-Autoren ab.

BaseUri

Ruft den Basis-URI für die SyndicationFeed-Instanz ab oder legt ihn fest.

Categories

Ruft eine Auflistung der Feed-Kategorien ab.

Contributors

Ruft eine Auflistung der Beiträger zum Feed ab.

Copyright

Ruft die Copyrightinformationen für den Feed ab oder legt sie fest.

Description

Ruft die Beschreibung der Warteschlange ab oder legt diese fest.

Documentation

Ruft den Link zur Dokumentation des Feeds ab oder legt ihn fest.

ElementExtensions

Ruft die Elementerweiterungen für den Feed auf.

Generator

Ruft den Generator des Feeds ab oder legt ihn fest.

Id

Ruft die ID des Feeds ab oder legt sie fest.

ImageUrl

Ermittelt die Bild-URL des Feeds oder legt sie fest.

Items

Ruft eine Sammlung der Feed-Elemente im Feed ab.

Language

Ruft die Sprache des Feeds ab oder legt sie fest.

LastUpdatedTime

Ruft die Zeit des letzten Updates des Feeds ab oder legt sie fest.

Links

Ermittelt die Links des Feed.

SkipDays

Ruft eine Sammlung von Zeichenfolgen ab, die die Werte im „skipDays“-Element für den Feed angeben.

SkipHours

Ruft eine Sammlung von Integern ab, die den Satz von Werten im „skipHours“-Element für den Feed angeben.

TextInput

Ruft die TextInput-Eigenschaft des Feeds ab oder legt sie fest.

TimeToLive

Ruft das ttl-Attribut des Feeds ab oder legt es fest.

Title

Ruft den Titel des Feeds ab oder legt ihn fest.

Methoden

Clone(Boolean)

Erstellt eine Kopie der SyndicationFeed-Instanz.

CreateCategory()

Erstellt eine neue SyndicationCategory-Instanz.

CreateItem()

Erstellt eine neue SyndicationItem-Instanz.

CreateLink()

Erstellt eine neue SyndicationLink-Instanz.

CreatePerson()

Erstellt eine neue SyndicationPerson-Instanz.

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetAtom10Formatter()

Ruft eine Atom10FeedFormatter-Instanz ab.

GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetRss20Formatter()

Ruft eine Rss20FeedFormatter-Instanz ab.

GetRss20Formatter(Boolean)

Ruft eine neue Rss20FeedFormatter-Instanz ab.

GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
Load(XmlReader)

Lädt einen Syndication-Feed vom angegebenen XML-Reader.

Load<TSyndicationFeed>(XmlReader)

Lädt eine von SyndicationFeed abgeleitete Instanz vom angegebenen XmlReader.

MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
SaveAsAtom10(XmlWriter)

Schreiben Sie den Syndication-Feed im Atom&#160;1.0-Format in den angegebenen XmlWriter.

SaveAsRss20(XmlWriter)

Schreiben Sie den Syndication-Feed im RSS&#160;2.0-Format in den angegebenen XmlWriter.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)
TryParseAttribute(String, String, String, String)

Versucht, eine Attributerweiterung zu analysieren.

TryParseElement(XmlReader, String)

Versucht, eine Elementerweiterung zu analysieren.

WriteAttributeExtensions(XmlWriter, String)

Schreibt die Attributerweiterungen in den angegebenen XmlWriter und verwendet hierbei die angegebene Syndication-Version.

WriteElementExtensions(XmlWriter, String)

Schreibt die Elementerweiterungen in den angegebenen XmlWriter und verwendet hierbei die angegebene Syndication-Version.

Gilt für