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