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 (外部标记)	---	---	---
作者	author	作者	---
BaseUri	---	---	---
类别	category	category	---
CommentsUri	comments	---	---
内容	---	内容	---
供稿人	---	参与者	---
EditMediaUri	---	link with rel=“edit-media”	---
EditUri	---	link with rel=“edit”	---
ElementExtensions (外部标记)	---	---	---
Etag	---	---	CreateResourceAsync 后的 ETag 标头
Id	guid	id	CreateResourceAsync 之后的位置标头
ItemUri	---	---	---
语言	xml:lang	xml:lang	---
LastUpdatedTime	---	已更新	---
链接	link/enclosure	链接	---
NodeName	---	---	---
NodeNamespace	---	---	---
NodeValue	---	---	---
PublishedDate	pubDate	published	---
权限	---	权限	---
Source	source	source	---
摘要	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：参与者 元素的集合。
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 元素或源元素。
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)