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 (外部標記) | --- | --- | --- |
| 作者 | 編寫 | 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 內容。 |