SyndicationFeed Klasse

Referenz

Definition

Namespace:: System.ServiceModel.Syndication

Assembly:: System.ServiceModel.Syndication.dll

Assemblys:: System.ServiceModel.dll, System.ServiceModel.Syndication.dll

Assembly:: System.ServiceModel.Web.dll

Assembly:: System.ServiceModel.dll

Assemblys:: System.ServiceModel.dll, System.ServiceModel.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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: Object
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 1.0-Format in den angegebenen XmlWriter.
SaveAsRss20(XmlWriter)	Schreiben Sie den Syndication-Feed im RSS 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