À propos de l’objet Query

[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.]

L’objet Query représente une requête composée. Vous créez un objet Query vide en appelant mediaCollection. createQuery. Une fois que vous avez créé un objet Query , vous pouvez appeler addCondition pour ajouter une condition à la requête composée. Chaque appel suivant à addCondition ajoute une nouvelle condition à la requête existante à l’aide de la logique AND.

Par exemple, supposons que vous souhaitiez créer une requête qui représente tous les médias numériques où WM/Genre est égal à « Jazz » et Author contient « Jim ». Vous pouvez créer une requête composée pour représenter ces conditions à l’aide du code JScript suivant :

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

// Add the conditions.
Query.addCondition("WM/Genre", "Equals", "Jazz");
Query.addCondition("Author", "Contains", "Jim");

Pour ajouter une condition à une requête composée à l’aide de la logique OR, vous devez appeler Query.beginNextGroup. Cette méthode indique que le groupe de conditions précédent est terminé et que l’appel suivant à addCondition représente le début d’un nouveau groupe de conditions.

Par exemple, pour créer une requête qui représente tous les médias numériques où WM/Genre est égal à « Jazz » et Author contient « Jim » ou Author contient « Dave », vous pouvez utiliser l’exemple de code suivant :

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

// Add the conditions.
Query.addCondition("WM/Genre", "Equals", "Jazz");
Query.addCondition("Author", "Contains", "Jim");

// Start the next condition group. This group will be
// combined with the previous group using a logical OR operation.
Query.beginNextGroup();

// Add the conditions.
Query.addCondition("WM/Genre", "Equals", "Jazz");
Query.addCondition("Author", "Contains", "Dave");

Pour exécuter votre requête composée, appelez MediaCollection.getPlaylistByQuery.

Rubriques connexes

MediaCollection.getPlaylistByQuery

Modèle objet lecteur pour les langages de script

Objet de requête