Query. addCondition, méthode

La méthode addCondition ajoute une condition à l’objet de requête à l’aide de et de la logique.

Syntaxe

Query.addCondition(
  attribute,
  operator,
  value
)

Paramètres

attribut [ dans]

Chaîne contenant le nom de l’attribut.

opérateur [ dans]

Chaîne contenant l’opérateur. Consultez la section Notes pour connaître les valeurs prises en charge.

valeur [ dans]

Chaîne contenant la valeur de l’attribut.

Valeur de retour

Cette méthode ne retourne pas de valeur.

Notes

Les requêtes composées à l’aide de la requête ne respectent pas la casse.

Vous trouverez une liste de valeurs pour le paramètre attribut dans la section référence des attributs alphabétiques .

Les conditions contenues dans un objet de requête sont organisées en groupes de conditions. Plusieurs conditions au sein d’un groupe de conditions sont toujours concaténées à l’aide de et de la logique. Les groupes de conditions sont toujours concaténés entre eux à l’aide de ou logique. Pour démarrer un nouveau groupe de conditions, appelez query. beginNextGroup.

Le tableau suivant répertorie les valeurs prises en charge pour l' opérateur.

Opérateur S’applique à
BeginsWith Chaînes
Contient Chaînes
Égal à Tous les types
GreaterThan Nombres, dates
Supérieur ou égal à Nombres, dates
LessThan Nombres, dates
Inférieur ou égal à Nombres, dates
NotBeginsWith Chaînes
NotContains Chaînes
NotEquals Tous les types

Exemples

l’exemple de JScript suivant utilise query. addCondition et query. beginNextGroup pour exécuter un exemple de requête.

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

Configuration requise

Condition requise Valeur
Version
Lecteur Windows Media 11.
DLL
Wmp.dll

Voir aussi

MediaCollection. createQuery

MediaCollection.getPlaylistByQuery

MediaCollection.getStringCollectionByQuery

Objet Query

Query. beginNextGroup