SyndicationItem 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
表示源中的项。 此类封装 RSS 2.0 中的 /rss/channel/item 元素或 Atom 1.0 中的 atom:entry 元素中的信息。
public ref class SyndicationItem sealed
/// [Windows.Foundation.Metadata.Activatable(Windows.Web.Syndication.ISyndicationItemFactory, 65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [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)]
class SyndicationItem final
/// [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.Activatable(typeof(Windows.Web.Syndication.ISyndicationItemFactory), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[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)]
public sealed class SyndicationItem
[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
- 继承
- 属性
- 实现
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 内容。 |