MediaCollection. getByAttribute 方法

GetByAttribute 方法检索包含指定属性值的媒体项的播放列表。

语法

retVal = MediaCollection.getByAttribute(
  attribute,
  value
)

参数

特性 [中]

指示要搜索的属性名称的 字符串。 有关 Windows Media Player 支持的属性的信息,请参阅 Windows Media Player特性引用

[中]

指示属性应具有的值的 字符串

返回值

此方法返回一个 播放列表 对象。

备注

此方法可用于为媒体项创建与数据库中属性的值相匹配的一般查询。 这对于用户定义的属性很有用。 如果该属性不存在,则会导致错误。

您可以使用此方法检索特定类型的所有媒体项。 使用属性名称 "媒体名称" 和以下值之一:

说明
音频 音乐和其他仅音频项。
播放列表 表示为 媒体 对象的播放列表。
radio 无线电站项。 不是由 Windows Media Player 10 使用。
视频 视频项。
照片 照片项目。 需要 Windows Media Player 10。
其他 其他项目,如 ASF 文件或流式处理媒体的 Url。

若要使用此方法,需要对库的读取权限。 有关详细信息,请参阅 库访问

示例

以下 JScript 示例使用 MediaCollectiongetByAttribute 通过名为 Triode 48 的艺术家播放库中的所有内容。 已创建 ID 为 "Player" 的 播放机 对象。

// Get a playlist object filled with media items by a 
// particular artist.
var pl = Player.mediaCollection.getByAttribute("Artist", "Triode 48");

// Make the new playlist the current one.
Player.currentPlaylist = pl;

// Start Windows Media Player.
Player.controls.play();

要求

要求
版本
Windows Media Player 版本7.0 或更高版本。
DLL
Wmp.dll

另请参阅

MediaCollection 对象

播放列表对象

设置. mediaAccessRights

设置. requestMediaAccessRights