list.csv

  • 發行項

[與此頁面相關聯的功能Windows 媒體播放機 SDK是舊版功能。 MediaPlayer已取代它。 MediaPlayer已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用MediaPlayer，而不是Windows 媒體播放機 SDK。 Microsoft 建議使用舊版 API 的現有程式碼盡可能重寫為使用新的 API。

此檔案包含目錄包含之每個清單的專案。 清單可以是曲目、相簿、作者、內容類型、子genres 或無線電摘要的清單;或可以是其他清單的清單。 每個清單專案都是由下表所述的索引標籤分隔欄位所組成的資料列。 欄位必須依列出的順序顯示。

下表中的 [格式] 資料行描述每個 Unicode 文字欄位格式化的方式。 它不會參考內容的資料類型。 例如，如果 Format 資料行中指出 Integer，則表示欄位包含代表整數值的 Unicode 字串，而不是實際的整數。

欄位 必要 格式 描述
ListID 是 非負整數。 清單識別碼，在list.csv內是唯一的。 必須是非負數且小於 2^32。在樹狀檢視控制項中顯示清單節點： 如果 ListID 是 0、1、2、3、4、5、6 或 7，清單會顯示為線上商店最上層節點底下的播放機樹狀檢視控制項中的自訂節點。 自訂節點會出現在線上商店最上層節點下的標準節點之前，而且它們會依 ListID 的遞增順序排列。 例如，如果有三個自訂節點，其中 ListID 為 1、3 和 5，則會在線上商店的最上層節點底下顯示第一個、第二個和第三個。
ListTitle 否 Unicode 字串。範例：前十名點擊數
 清單標題。
ListSubtitle 否 Unicode 字串 列出替代標題，顯示在 [磚] 檢視的第二行。
ListDescription 是 Unicode 字串 列出易記的顯示文字 (顯示在屬性頁) 。
Linked_ItemType 是 Unicode 字串。格式：[T|P|A|L|G|S|R]
範例：T
 指出連結專案的型別。
  • T= 追蹤
  • P = 執行者
  • A = 相簿
  • L = 清單
  • G = 內容類型
  • S = 子genre
  • R = 無線電
ListPrice 是 Unicode 字串。範例：$9.99
 清單的價格。 應包含貨幣符號。零表示清單是免費的。 沒有值表示價格不明。 連字號表示無法購買清單。
熱門程度 是 整數或十進位值。範例：1259.3
 指出此清單出現在其他清單中時的熱門排名。 如果不適用，可以為零。
IsRecentlyAdded 是 Boolean.Format： [0|1]
範例：0
 指出最近是否新增清單。
IsFeatured 是 Boolean.Format： [0|1]
範例：0
 指出清單是否精選。 可用於判斷排序次序。
編輯文字 是 非負整數。 應該是 0。 此版本未使用。 應該是 0。
ViewType 是 Unicode 字串。 格式：[I|T|R|L|O]範例： T
 指出要用於清單的檢視類型。
  • I = 圖示
  • T = 磚
  • R = 報表
  • L = 清單
  • O = 已排序清單
ViewImageSize 是 非負整數。範例：180
 顯示清單影像的大小。 如果為 0，則會自動決定大小。
群組依據 是 Unicode 字串。格式：[-|P|A|C|R|D]
範例：P
 指出用來將清單中的專案分組的欄位。
  • - = 自動
  • P = 執行者
  • A = 相簿
  • C = Composer
  • R = 評等
  • D = 日期
ListItemsAreDynamic 是 布林值。 可以是 0 或 1。 指出清單是否以動態方式產生。 動態清單在 listitem.csv中沒有專案。 如果清單標示為動態，其專案會由IWMPContentPartner：：GetListContents提供