Método Query.addCondition

[La característica asociada a esta página, Reproductor multimedia de Windows SDK, es una característica heredada. Se ha reemplazado por MediaPlayer. MediaPlayer se ha optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer en lugar de Reproductor multimedia de Windows SDK, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

El método addCondition agrega una condición al objeto Query mediante la lógica AND.

Sintaxis

Query.addCondition(
  attribute,
  operator,
  value
)

Parámetros

atributo [in]

Cadena que contiene el nombre del atributo.

operator [in]

Cadena que contiene el operador . Consulte Comentarios para ver los valores admitidos.

value [in]

Cadena que contiene el valor del atributo.

Valor devuelto

Este método no devuelve ningún valor.

Observaciones

Las consultas compuestas que usan Query no distinguen mayúsculas de minúsculas.

Puede encontrar una lista de valores para el parámetro de atributo en la sección Referencia de atributos alfabéticos .

Las condiciones contenidas en un objeto Query se organizan en grupos de condiciones. Varias condiciones dentro de un grupo de condiciones siempre se concatenan mediante la lógica AND. Los grupos de condiciones siempre se concatenan entre sí mediante la lógica OR. Para iniciar un nuevo grupo de condiciones, llame a Query.beginNextGroup.

En la tabla siguiente se enumeran los valores admitidos para el operador .

Operador	Se aplica a
BeginsWith	Cadenas
Contains	Cadenas
Equals	Todos los tipos
GreaterThan	Números, fechas
GreaterThanOrEquals	Números, fechas
LessThan	Números, fechas
LessThanOrEquals	Números, fechas
NotBeginsWith	Cadenas
NotContains	Cadenas
NotEquals	Todos los tipos

Ejemplos

En el siguiente ejemplo de JScript se usa Query.addCondition y Query.beginNextGroup para realizar una consulta de ejemplo.

// 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

Requisitos

Requisito	Value
Versión	Reproductor multimedia de Windows 11.
Archivo DLL	Wmp.dll

Consulte también

MediaCollection.createQuery

MediaCollection.getPlaylistByQuery

MediaCollection.getStringCollectionByQuery

Query (objeto)

Query.beginNextGroup