DownloadItem 对象

[与此页面关联的功能(Windows 媒体播放器 SDK)是旧版功能。 它已被 MediaPlayer 取代。 MediaPlayer 已针对Windows 10和Windows 11进行了优化。 如果可能,Microsoft 强烈建议新代码使用 MediaPlayer 而不是 Windows 媒体播放器 SDK。 如果可能,Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

注意

本部分介绍专为在线商店使用而设计的功能。 不支持在在线商店上下文之外使用此功能。

 

DownloadItem 对象表示文件下载请求。 在完整模式下托管Windows 媒体播放器并且有权访问外部对象的网页(例如高级服务)可以使用它。

DownloadItem 对象支持以下属性。

属性 描述
downloadState 检索下载的状态。
进度 检索下载进度(以字节为单位)。
size 检索下载的大小。
sourceURL 检索下载的源 URL。
type 检索下载的类型。

 

DownloadItem 对象支持以下方法。

方法 说明
cancel 取消下载。
getItemInfo 检索下载项的 属性值。
pause 暂停下载。
恢复 恢复下载。

 

通过以下属性访问 DownloadItem 对象。

Object 属性
DownloadCollection item

 

出于说明目的, DownloadManagergetDownloadCollection (collectionId) 。item (itemId) 用于参考语法部分。

类型 2 在线商店的参考