SyndicationFeed クラス

定義

トップレベルのフィード オブジェクトである、Atom 1.0 の <feed> と RSS 2.0 の <rss> を表します。Represents a top-level feed object, <feed> in Atom 1.0 and <rss> in RSS 2.0.

public ref class SyndicationFeed
public class SyndicationFeed
type SyndicationFeed = class
Public Class SyndicationFeed
継承
SyndicationFeed

SyndicationFeed インスタンスを作成し、Atom 1.0 と RSS 2.0 の両方にシリアル化する方法を次のコードに示します。The following code shows how to create a SyndicationFeed instance and serialize it to both Atom 1.0 and 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()

SyndicationFeed を Atom 1.0 にシリアル化する方法を次の XML に示します。The following XML shows how a SyndicationFeed is serialized to Atom 1.0.

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

SyndicationFeed インスタンスを RSS 2.0 にシリアル化する方法を次の XML に示します。The following XML shows how a SyndicationFeed instance is serialized to RSS 2.0.

<rss xmlns:a10="http://www.w3.org/2005/Atom" version="2.0">
  <channel CustomAttribute="Value">
    <title>Feed Title</title>
    <link>http://feed/Alternate/Link</link>
    <description>This is a sample feed</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>Feed Title</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>Item Title</title>
      <description>Some text content</description>
      <a10:updated>2007-04-13T17:29:38Z</a10:updated>
    </item>
  </channel>
</rss>

注釈

Atom 1.0 にシリアル化する場合、SyndicationFeed インスタンスは <feed> 要素に書き込まれます。When serialized to Atom 1.0, a SyndicationFeed instance is written to a <feed> element. 次の表は、SyndicationFeed に定義されている各プロパティが Atom 1.0 にシリアル化される方法を示しています。The following table shows how each property defined in the SyndicationFeed class is serialized to Atom 1.0.

SyndicationFeed プロパティSyndicationFeed property シリアル化された形式Serialized form
AttributeExtensions コレクション内の各属性の <feed> 要素内の属性。An attribute in the <feed> element for each attribute in the collection.
Authors コレクション内の各 SyndicationPerson<author> 要素。An <author> element for each SyndicationPerson in the collection.
Categories コレクション内の各 SyndicationCategory<category> 要素。A <category> element for each SyndicationCategory in the collection.
Contributors コレクション内の各 SyndicationPerson<contributor> 要素。A <contributor> element for each SyndicationPerson in the collection.
Copyright <rights> 要素。A <rights> element.
Description <subtitle> 要素。A <subtitle> element.
ElementExtensions コレクション内の各要素は、<feed> 要素内に記述されます。Each element in the collection is written within the <feed> element.
Generator <generator> 要素。A <generator> element.
Id <id>要素。An <id>element.
ImageUri <logo> 要素。A <logo> element.
Items コレクション内の各 SyndicationItem<entry> 要素。An <entry> element for each SyndicationItem in the collection.
Language シリアル化されません。Not serialized.
LastUpdatedTime <updated> 要素。An <updated> element.
Links コレクション内の各 SyndicationLink<link> 要素。A <link> element for each SyndicationLink in the collection.
Title <title> 要素。A <title> element.

RSS 2.0 にシリアル化する際、SyndicationFeed インスタンスは <rss> 要素に書き込まれます。When serialized to RSS 2.0, a SyndicationFeed instance is written to an <rss> element. 次の表は、SyndicationFeed に定義されている各プロパティが RSS 2.0 にシリアル化される方法を示しています。The following table shows how each property defined in the SyndicationFeed class is serialized to RSS 2.0.

SyndicationFeed プロパティSyndicationFeed property シリアル化された形式Serialized form
AttributeExtensions コレクション内の各属性の <channel> 要素内の属性。An attribute in the <channel> element for each attribute in the collection.
Authors コレクション内に SyndicationPerson が1つしかない場合は <managingEditor> 要素。それ以外の場合は、コレクション内の各 SyndicationPerson<a10:author> 要素。A <managingEditor> element if only one SyndicationPerson is in the collection; otherwise, an <a10:author> element for each SyndicationPerson in the collection.
Categories コレクション内の各 SyndicationCategory<category> 要素。A <category> element for each SyndicationCategory in the collection.
Contributors コレクション内の各 SyndicationPerson<a10:contributor> 要素。An <a10:contributor> element for each SyndicationPerson in the collection.
Copyright <copyright> 要素。A <copyright> element.
Description <description> 要素。A <description> element.
ElementExtensions コレクション内の各要素は、<channel> 要素内に記述されます。Each element in the collection is written within the <channel> element.
Generator <generator> 要素。A <generator> element.
Id <a10:id> 要素。An <a10:id> element.
ImageUri <image> 要素。An <image> element.
Items コレクション内の各 SyndicationItem<item> 要素。An <item> element for each SyndicationItem in the collection.
Language <language> 要素。A <language> element.
LastUpdatedTime <lastBuildDate> 要素。A <lastBuildDate> element.
Links コレクション内の各 SyndicationLink<a10:link> 要素。An <a10:link> element for each SyndicationLink in the collection.
Title <title> 要素。A <title> element.

コンストラクター

SyndicationFeed()

SyndicationFeed クラスの新しいインスタンスを初期化します。Initializes a new instance of the SyndicationFeed class.

SyndicationFeed(IEnumerable<SyndicationItem>)

指定した SyndicationFeed オブジェクトのコレクションを使用して、 SyndicationItem クラスの新しいインスタンスを初期化します。Initializes a new instance of the SyndicationFeed class with the specified collection of SyndicationItem objects.

SyndicationFeed(String, String, Uri)

指定したタイトル、説明、および URI (Uniform Resource Identifier) を使用して、 SyndicationFeed クラスの新しいインスタンスを初期化します。Initializes a new instance of the SyndicationFeed class with the specified title, description, and Uniform Resource Identifier (URI).

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

指定したタイトル、説明、URI、および SyndicationFeed オブジェクトのコレクションを使用して、 SyndicationItem クラスの新しいインスタンスを初期化します。Initializes a new instance of the SyndicationFeed class with the specified title, description, URI, and collection of SyndicationItem objects.

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

SyndicationFeed クラスの新しいインスタンスを作成します。Creates a new instance of the SyndicationFeed class.

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

SyndicationFeed クラスの新しいインスタンスを作成します。Creates a new instance of the SyndicationFeed class.

SyndicationFeed(SyndicationFeed, Boolean)

指定したフィードを使用して、 SyndicationFeed クラスの新しいインスタンスを作成します。Creates a new instance of the SyndicationFeed class with the specified feed.

プロパティ

AttributeExtensions

属性の拡張のコレクションを取得します。Gets a collection of attribute extensions.

Authors

フィードの作成者のコレクションを取得します。Gets a collection of authors of the feed.

BaseUri

SyndicationFeed インスタンスのベース URI を取得または設定します。Gets or sets the base URI for the SyndicationFeed instance.

Categories

フィードに対するカテゴリのコレクションを取得します。Gets a collection of categories for the feed.

Contributors

フィードの投稿者のコレクションを取得します。Gets a collection of the contributors to the feed.

Copyright

フィードの著作権情報を取得または設定します。Gets or sets copyright information for the feed.

Description

フィードの説明を取得または設定します。Gets or sets a description of the feed.

Documentation

フィードに関するドキュメントへのリンクを取得または設定します。Gets or sets the link to documentation for the feed.

ElementExtensions

フィードの要素拡張を取得します。Gets the element extensions for the feed.

Generator

フィードのジェネレーターを取得または設定します。Gets or sets the generator of the feed.

Id

フィードの ID を取得または設定します。Gets or sets the ID of the feed.

ImageUrl

フィードのイメージの URL を取得または設定します。Gets or sets the image URL for the feed.

Items

このフィードに格納されるフィード項目のコレクションを取得します。Gets a collection of the feed items contained in the feed.

Language

フィードの言語を取得または設定します。Gets or sets the language of the feed.

LastUpdatedTime

フィードが最後に更新された時刻を取得または設定します。Gets or sets the time the feed was last updated.

Links

フィードに関連付けられたリンクを取得します。Gets the links associated with the feed.

SkipDays

フィード用の 'skipDays ' 要素内の値のセットを示す文字列のコレクションを取得します。Gets a collection of strings indicating the set of values in the 'skipDays' element for the feed.

SkipHours

フィード用の 'skipHours' 要素内の値のセットを示す整数のコレクションを取得します。Gets a collection of integers indicating the set of values in the 'skipHours' element for the feed.

TextInput

フィード用の TextInput プロパティを取得または設定します。Gets or sets the TextInput property for the feed.

TimeToLive

フィード用の 'ttl' 属性を取得または設定します。Gets or sets the 'ttl' attribute for the feed.

Title

フィードのタイトルを取得または設定します。Gets or sets the title of the feed.

メソッド

Clone(Boolean)

SyndicationFeed インスタンスのコピーを作成します。Creates a copy of the SyndicationFeed instance.

CreateCategory()

新しい SyndicationCategory インスタンスを作成します。Creates a new SyndicationCategory instance.

CreateItem()

新しい SyndicationItem インスタンスを作成します。Creates a new SyndicationItem instance.

CreateLink()

新しい SyndicationLink インスタンスを作成します。Creates a new SyndicationLink instance.

CreatePerson()

新しい SyndicationPerson インスタンスを作成します。Creates a new SyndicationPerson instance.

Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(継承元 Object)
GetAtom10Formatter()

Atom10FeedFormatter インスタンスを取得します。Gets an Atom10FeedFormatter instance.

GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(継承元 Object)
GetRss20Formatter()

Rss20FeedFormatter インスタンスを取得します。Gets an Rss20FeedFormatter instance.

GetRss20Formatter(Boolean)

新しい Rss20FeedFormatter インスタンスを取得します。Gets a new Rss20FeedFormatter instance.

GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(継承元 Object)
Load(XmlReader)

指定した XML リーダーから配信フィードを読み込みます。Loads a syndication feed from the specified XML reader.

Load<TSyndicationFeed>(XmlReader)

SyndicationFeedの派生インスタンスを、指定した XmlReaderから読み込みます。Loads a SyndicationFeed-derived instance from the specified XmlReader.

MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(継承元 Object)
SaveAsAtom10(XmlWriter)

配信フィードを、Atom 1.0 形式の指定した XmlWriter に書き込みます。Write the syndication feed to the specified XmlWriter in Atom 1.0 format.

SaveAsRss20(XmlWriter)

配信フィードを、RSS 2.0 形式の指定した XmlWriter に書き込みます。Write the syndication feed to the specified XmlWriter in RSS 2.0 format.

ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(継承元 Object)
TryParseAttribute(String, String, String, String)

属性の拡張の解析を試みます。Attempts to parse an attribute extension.

TryParseElement(XmlReader, String)

要素拡張の解析を試みます。Attempts to parse an element extension.

WriteAttributeExtensions(XmlWriter, String)

属性の拡張を、指定した配信バージョンを使用して、指定した XmlWriter に書き込みます。Writes the attribute extensions to the specified XmlWriter using the specified syndication version.

WriteElementExtensions(XmlWriter, String)

要素拡張を、指定された配信バージョンを使用して、指定された XmlWriter に書き込みます。Writes the element extensions to the specified XmlWriter using the specified syndication version.

適用対象