Query.addCondition-Methode

[Das dieser Seite zugeordnete Feature Windows Medienwiedergabe SDK ist ein Legacyfeature. Es wurde von MediaPlayer abgelöst. MediaPlayer wurde für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, mediaPlayer anstelle von Windows Medienwiedergabe SDK für neuen Code zu verwenden. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Die addCondition-Methode fügt dem Query-Objekt mithilfe der AND-Logik eine Bedingung hinzu.

Syntax

Query.addCondition(
  attribute,
  operator,
  value
)

Parameter

Attribut [in]

Zeichenfolge , die den Attributnamen enthält.

Operator [in]

Zeichenfolge , die den Operator enthält. Informationen zu unterstützten Werten finden Sie unter Hinweise.

Wert [in]

Zeichenfolge mit dem Attributwert.

Rückgabewert

Diese Methode gibt keinen Wert zurück.

Bemerkungen

Bei zusammengesetzten Abfragen mit Abfrage wird die Groß-/Kleinschreibung nicht beachtet.

Eine Liste der Werte für den Attributparameter finden Sie im Abschnitt Alphabetische Attributreferenz .

Bedingungen, die in einem Query-Objekt enthalten sind, werden in Bedingungsgruppen organisiert. Mehrere Bedingungen innerhalb einer Bedingungsgruppe werden immer mithilfe der AND-Logik verkettet. Bedingungsgruppen werden immer mithilfe von OR-Logik miteinander verkettet. Um eine neue Bedingungsgruppe zu starten, rufen Sie Query.beginNextGroup auf.

In der folgenden Tabelle sind die unterstützten Werte für operator aufgeführt.

Betreiber	Gilt für:
BeginsWith	Zeichenfolgen
Enthält	Zeichenfolgen
Equals	Alle Typen
GreaterThan	Zahlen, Datumsangaben
Größer als oder gleich	Zahlen, Datumsangaben
LessThan	Zahlen, Datumsangaben
Kleiner als oder gleich	Zahlen, Datumsangaben
NotBeginsWith	Zeichenfolgen
NotContains	Zeichenfolgen
NotEquals	Alle Typen

Beispiele

Im folgenden JScript-Beispiel werden Query.addCondition und Query.beginNextGroup verwendet, um eine Beispielabfrage auszuführen.

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

Anforderungen

Anforderung	Wert
Version	Windows Medienwiedergabe 11.
DLL	Wmp.dll

Siehe auch

MediaCollection.createQuery

MediaCollection.getPlaylistByQuery

MediaCollection.getStringCollectionByQuery

Query-Objekt

Query.beginNextGroup