SyndicationItem 類別

定義

命名空間:

Windows.Web.Syndication

表示摘要中的專案。 這個類別會將資訊封裝在 RSS 2.0 中的 /rss/channel/item 元素，或 Atom 1.0 中的 atom：entry 元素中。

public ref class SyndicationItem sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Web.Syndication.ISyndicationItemFactory, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class SyndicationItem final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Web.Syndication.ISyndicationItemFactory), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class SyndicationItem

function SyndicationItem(title, content, uri)

Public NotInheritable Class SyndicationItem

繼承

Object Platform::Object IInspectable SyndicationItem

屬性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

實作

ISyndicationNode

Windows 需求

裝置系列	Windows 10 (已於 10.0.10240.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v1.0 引進)

備註

下列程式代碼示範如何存取 SyndicationItem 物件的屬性值。

using Windows.Foundation;
using Windows.Web.Syndication;

private void DisplayCurrentItem()
{
    SyndicationItem item = currentFeed.Items[currentItemIndex];

    // Title
    FeedItemTitle.Text = item.Title != null ? item.Title.Text : "(no title)";

    // Display the main link
    string link = string.Empty;
    if (item.Links.Count > 0)
    {
    link = item.Links[0].Uri.AbsoluteUri;
    }
    FeedLink.Content = link;

    // Display the body as HTML
    string content = "(no content)";
    if (item.Content != null)
    {
        content = item.Content.Text;
    }
    else if (item.Summary != null)
    {
        content = item.Summary.Text;
    }
    FeedWebView.NavigateToString(content);
}

如需示範如何使用這個類別來代表摘要內容的其他範例，請參閱 快速入門：存取 Web 摘要。

下表將 SyndicationItem 屬性對應至 RSS 和 Atom 摘要元素。

SyndicationItem	RSS 通道/專案	Atom 專案	AtomPub
AttributeExtensions (外部標記)	---	---	---
作者	編寫	authors	---
BaseUri	---	---	---
類別	category	category	---
CommentsUri	comments	---	---
內容	---	內容	---
參與者	---	貢獻	---
EditMediaUri	---	連結與 rel=“edit-media”	---
EditUri	---	連結與 rel=“edit”	---
ElementExtensions (外部標記)	---	---	---
Etag	---	---	CreateResourceAsync 之後的 ETag 標頭
Id	guid	id	CreateResourceAsync 之後的位置標頭
ItemUri	---	---	---
Language	xml: lang	xml: lang	---
LastUpdatedTime	---	已更新	---
連結	連結/機箱	link	---
NodeName	---	---	---
NodeNamespace	---	---	---
NodeValue	---	---	---
PublishedDate	pubDate	published	---
權限	---	權限	---
來源	來源	來源	---
摘要	description	摘要	---
標題	title	title	---

建構函式

SyndicationItem()	建立新的 SyndicationItem 物件。
SyndicationItem(String, SyndicationContent, Uri)	使用標題、內容和 URI 建立新的 SyndicationItem 物件。

屬性

AttributeExtensions	取得專案的自定義屬性清單。
Authors	取得專案的作者。 這個屬性代表 atom：entry 下所有 atom：author 元素的集合。
BaseUri	取得或設定專案的基底 URI。 這個屬性代表 元素上的 xml：base 屬性。 它可以繼承自上階元素。
Categories	取得摘要類別的集合。 這個屬性代表 atom：feed 下所有 atom：category 元素的集合。
CommentsUri	取得或設定專案的批註 (URI) 統一資源識別符。 這個屬性代表 /rss/channel/item/comments 元素。
Content	取得或設定項目的內容。
Contributors	取得摘要參與者的集合。 這個屬性代表 atom：feed 下所有 atom：contributor 元素的集合。
EditMediaUri	取得可編輯媒體資源的統一資源標識碼 (URI) 。
EditUri	取得可編輯資源的統一資源標識碼 (URI) 。
ElementExtensions	取得 專案內的子項目清單。
ETag	取得ETag HTTP標頭。
Id	取得或設定新聞訂閱摘要的標識碼。
ItemUri	取得這個項目的統一資源標識碼 (URI) 。 AtomPubClient 會在建立新的資源之後建立這個屬性。
Language	取得或設定 項目的語言。 這個屬性代表 元素上的 xml：lang 屬性。 它可以繼承自上階元素。 它必須根據 XML 1.0 有效。
LastUpdatedTime	取得或設定最近修改項目的時間。 這個屬性代表 atom：updated 元素。
Links	取得專案中包含的連結。
NodeName	取得或設定專案的本機名稱。
NodeNamespace	取得或設定 專案的命名空間。
NodeValue	取得或設定 專案的文字內容。 如果專案只包含子專案，則此屬性為 NULL。
PublishedDate	取得或設定發行專案的日期。
Rights	取得或設定專案許可權的相關信息。 這個屬性代表 atom：rights 元素。
Source	取得或設定專案的來源摘要。 這個屬性代表 RSS 2.0 中的 atom：source 元素或 source 元素。
Summary	取得或設定專案的摘要。
Title	取得或設定項目的標題。

方法

GetXmlDocument(SyndicationFormat)	產生代表這個專案的 DOM 物件，包括外部標記的所有屬性和子專案。 這個方法唯一接受的格式是 Atom 1.0 和 RSS 2.0。
Load(String)	從指定的摘要字串初始化 物件，此字串可以是 RSS 2.0 或 Atom 1.0 格式。
LoadFromXml(XmlDocument)	從指定的 DOM 物件初始化 對象，這個物件可以包含 RSS 2.0 或 Atom 1.0 格式的 XML 內容。

另請參閱

• 快速入門：存取 Web 摘要
• 新聞訂閱範例
• AtomPub 範例
• 新聞訂閱範例 (Windows 10)