Query.addCondition 方法

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

addCondition 方法使用 AND 逻辑向 Query 对象添加条件。

语法

Query.addCondition(
  attribute,
  operator,
  value
)

参数

attribute [in]

包含属性名称的字符串。

运算符 [in]

包含 运算符的字符串。 有关支持的值，请参阅备注。

value [in]

包含属性值的字符串。

返回值

此方法不返回值。

备注

使用 Query 的复合查询不区分大小写。

可以在按字母顺序的属性引用部分找到属性参数的值列表。

Query 对象中包含的条件组织为条件组。 始终使用 AND 逻辑连接一个条件组中的多个条件。 条件组始终使用 OR 逻辑相互连接。 若要启动新的条件组，请调用 Query.beginNextGroup。

下表列出了 运算符支持的值。

运算符	适用于
BeginsWith	字符串
Contains	字符串
等于	所有类型
GreaterThan	数字、日期
GreaterThanOrEquals	数字、日期
LessThan	数字、日期
LessThanOrEquals	数字、日期
NotBeginsWith	字符串
NotContains	字符串
NotEquals	所有类型

示例

以下 JScript 示例使用 Query.addCondition 和 Query.beginNextGroup 执行示例查询。

// Perform an example query for media for which:
// The genre contains "jazz"
// and the title begins with "a"
// OR the genre contains "jazz"
// and the author begins with "b".

// Create the query object.
var Query = Player.mediaCollection.createQuery();

// Add the first condition group.
Query.addCondition("WM/Genre", "Contains", "jazz");
Query.addCondition("Title", "BeginsWith", "a");

// Begin the new condition group ("or").
Query.beginNextGroup();

// Add the second condition group.
Query.addCondition("WM/Genre", "Contains", "jazz");
Query.addCondition("Author", "BeginsWith", "b");

// Perform the query on "audio" media.
var Playlist = Player.mediaCollection.getPlaylistByQuery(
    Query,      // query
    "audio",    // mediaType
    "",         // sortAttribute
    false);     // sortAscending

要求

要求	值
版本	Windows 媒体播放器 11.
DLL	Wmp.dll

另请参阅

MediaCollection.createQuery

MediaCollection.getPlaylistByQuery

MediaCollection.getStringCollectionByQuery

查询对象

Query.beginNextGroup