Méthode Query.addCondition

[La fonctionnalité associée à cette page, Lecteur multimédia Windows SDK, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer. MediaPlayer a été optimisé pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer au lieu de Lecteur multimédia Windows SDK, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

La méthode addCondition ajoute une condition à l’objet Query à l’aide de la logique AND.

Syntaxe

Query.addCondition(
  attribute,
  operator,
  value
)

Paramètres

attribut [in]

Chaîne contenant le nom de l’attribut.

opérateur [in]

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

value [in]

Chaîne contenant la valeur de l’attribut.

Valeur retournée

Cette méthode ne retourne pas de valeur.

Notes

Les requêtes composées qui utilisent query ne respectent pas la casse.

Vous trouverez la liste des valeurs du paramètre d’attribut dans la section Référence d’attribut alphabétique .

Les conditions contenues dans un objet Query sont organisées en groupes de conditions. Plusieurs conditions au sein d’un groupe de conditions sont toujours concaténées à l’aide de la logique AND. Les groupes de conditions sont toujours concaténés entre eux à l’aide de la logique OR. 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 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 multimédia Windows 11.
DLL	Wmp.dll

Voir aussi

MediaCollection.createQuery

MediaCollection.getPlaylistByQuery

MediaCollection.getStringCollectionByQuery

Objet de requête

Query.beginNextGroup