Metodo Query.addCondition

[La funzionalità associata a questa pagina, Lettore multimediale Windows SDK, è una funzionalità legacy. È stata sostituita da MediaPlayer. MediaPlayer è stato ottimizzato per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer anziché 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.

Il metodo addCondition aggiunge una condizione all'oggetto Query usando la logica AND.

Sintassi

Query.addCondition(
  attribute,
  operator,
  value
)

Parametri

attributo [in]

Stringa contenente il nome dell'attributo.

operatore [in]

Stringa contenente l'operatore. Vedere Osservazioni per i valori supportati.

valore [in]

Stringa contenente il valore dell'attributo.

Valore restituito

Questo metodo non restituisce valori.

Commenti

Le query composte che usano Query non sono distinzione tra maiuscole e minuscole.

Un elenco di valori per il parametro dell'attributo è disponibile nella sezione Riferimento attributo alfabetico .

Le condizioni contenute in un oggetto Query sono organizzate in gruppi di condizioni. Più condizioni all'interno di un gruppo di condizioni vengono sempre concatenate usando la logica AND. I gruppi di condizioni vengono sempre concatenati tra loro usando la logica OR. Per avviare un nuovo gruppo di condizioni, chiamare Query.beginNextGroup.

Nella tabella seguente sono elencati i valori supportati per l'operatore.

Operatore	Si applica a
BeginsWith	Stringhe
Contiene	Stringhe
Uguale a	Tutti i tipi
GreaterThan	Numeri, date
GreaterThanOrEquals	Numeri, date
LessThan	Numeri, date
LessThanOrEquals	Numeri, date
NotBeginsWith	Stringhe
NotContains	Stringhe
NotEquals	Tutti i tipi

Esempio

L'esempio JScript seguente usa Query.addCondition e Query.beginNextGroup per eseguire una query di esempio.

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

Requisiti

Requisito	Valore
Versione	Lettore multimediale Windows 11.
DLL	Wmp.dll

Vedi anche

MediaCollection.createQuery

MediaCollection.getPlaylistByQuery

MediaCollection.getStringCollectionByQuery

Oggetto Query

Query.beginNextGroup