MediaCollection.getStringCollectionByQuery-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 getStringCollectionByQuery-Methode ruft ein StringCollection-Objekt ab, das alle Zeichenfolgen enthält, die den Abfragebedingungen entsprechen.

Syntax

retVal = MediaCollection.getStringCollectionByQuery(
  attribute,
  query,
  mediaType,
  sortAttribute,
  sortAscending
)

Parameter

Attribut [in]

Zeichenfolge , die den Attributnamen enthält.

Abfrage [in]

Abfrageobjekt .

mediaType [in]

Zeichenfolge , die den Medientyp enthält. Muss einen der folgenden Werte enthalten: "audio", "video", "photo", "playlist" oder "other".

sortAttribute [in]

Zeichenfolge mit dem Attributnamen, der zum Sortieren verwendet wird. Eine leere Zeichenfolge ("") bedeutet, dass keine Sortierung angewendet wird.

sortAscending [in]

Boolean, true, der angibt, dass die StringCollection in aufsteigender Reihenfolge sortiert werden muss.

Rückgabewert

Diese Methode gibt ein StringCollection-Objekt zurück.

Bemerkungen

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

Wenn die durch den Abfrageparameter angegebene Verbundabfrage eine Bedingung enthält, die auf dem MediaType-Attribut basiert, wird diese Bedingung ignoriert. Der Wert für den mediaType-Parameter wird immer verwendet. Wenn die zusammengesetzte Abfrage beispielsweise die Bedingung "MediaType Equals audio" enthält und der Wert für den mediaType-Parameter "video" lautet, enthält die resultierende Wiedergabeliste nur Videoelemente.

Anforderungen

Anforderung	Wert
Version	Windows Medienwiedergabe 11.
DLL	Wmp.dll

Siehe auch

MediaCollection-Objekt

MediaType-Attribut

Query-Objekt