Informazioni sull'oggetto Query

[La funzionalità associata a questa pagina, Lettore multimediale Windows SDK, è una funzionalità legacy. È stato sostituito da MediaPlayer. MediaPlayer è stato ottimizzato per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer invece di Lettore multimediale Windows SDK, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

L'oggetto Query rappresenta una query composta. Per creare un nuovo oggetto Query vuoto, chiamare mediaCollection. createQuery. Dopo aver creato un oggetto Query , è possibile chiamare addCondition per aggiungere una condizione alla query composta. Ogni chiamata successiva a addCondition aggiunge una nuova condizione alla query esistente usando la logica AND.

Si supponga, ad esempio, di voler creare una query che rappresenta tutti i supporti digitali in cui WM/Genre è uguale a "Jazz" e Author contiene "Jim". È possibile creare una query composta per rappresentare queste condizioni usando il codice JScript seguente:

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

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

Per aggiungere una condizione a una query composta usando la logica OR, è necessario chiamare Query.beginNextGroup. Questo metodo segnala che il gruppo di condizioni precedente è stato completato e che la chiamata successiva a addCondition rappresenta l'inizio di un nuovo gruppo di condizioni.

Ad esempio, per creare una query che rappresenta tutti i supporti digitali in cui WM/Genre è uguale a "Jazz" e Author contiene "Jim" o Author contiene "Dave", è possibile usare il codice di esempio seguente:

// 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");

Per eseguire la query composta, chiamare MediaCollection.getPlaylistByQuery.

Argomenti correlati

MediaCollection.getPlaylistByQuery

Modello a oggetti player per i linguaggi di scripting

Oggetto Query