MediaCollection.getByAttribute-Methode

Die getByAttribute-Methode ruft eine Wiedergabeliste von Medienelementen ab, die einen angegebenen Wert für ein angegebenes Attribut enthalten.

Syntax

retVal = MediaCollection.getByAttribute(
  attribute,
  value
)

Parameter

Attribut [ In]

Eine Zeichenfolge, die den Namen des zu durchsuchenden Attributs angibt. Informationen zu den attributes, die von Windows Media Player unterstützt werden, finden Sie in der Windows Media Player Attribute Reference.

value [ In]

Eine Zeichenfolge, die den Wert angibt, über den das Attribut verfügen soll.

Rückgabewert

Diese Methode gibt ein Playlist-Objekt zurück.

Hinweise

Diese Methode kann verwendet werden, um eine generische Abfrage für Medienelemente zu erstellen, die mit einem Wert für ein Attribut in der Datenbank übereinstimmen. Dies ist bei benutzerdefinierten Attributen nützlich. Wenn das Attribut nicht vorhanden ist, tritt ein Fehler auf.

Sie können diese Methode verwenden, um alle Medienelemente eines bestimmten Typs abzurufen. Verwenden Sie den Attributnamen "MediaType" und einen der folgenden Werte:

Wert BESCHREIBUNG
Audio Musik und andere Nur-Audio-Elemente.
Playlist Wiedergabelisten, die als Medienobjekte dargestellt werden.
radio Radiostationselemente. Wird von Windows Media Player 10 nicht verwendet.
video Videoelemente.
Foto Fotoelemente. Erfordert Windows Media Player 10.
Andere Andere Elemente, z. B. ASF-Dateien oder URLs für Streamingmedien.

Um diese Methode verwenden zu können, ist Lesezugriff auf die Bibliothek erforderlich. Weitere Informationen finden Sie unter Bibliothekszugriff.

Beispiele

Im folgenden beispiel JScript MediaCollection verwendet. getByAttribute zum Wiederspielen aller Inhalte aus der Bibliothek durch den Interpreten namens Attributde 48. Das Player-Objekt wurde mit der ID = "Player" erstellt.

// Get a playlist object filled with media items by a 
// particular artist.
var pl = Player.mediaCollection.getByAttribute("Artist", "Triode 48");

// Make the new playlist the current one.
Player.currentPlaylist = pl;

// Start Windows Media Player.
Player.controls.play();

Anforderungen

Anforderung Wert
Version
Windows Media Player Version 7.0 oder höher.
DLL
Wmp.dll

Weitere Informationen

MediaCollection-Objekt

Wiedergabelistenobjekt

Einstellungen.mediaAccessRights

Einstellungen.requestMediaAccessRights