IWMPMediaCollection::getByAttribute-Methode

Artikel
06/21/2023

[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 getByAttribute-Methode gibt eine IWMPPlaylist-Schnittstelle zurück, die dem angegebenen Attribut mit dem angegebenen Wert entspricht.

Syntax

public IWMPPlaylist getByAttribute(
  System.String bstrAttribute,
  System.String bstrValue
);


Public Function getByAttribute( _
  ByVal bstrAttribute As System.String, _
  ByVal bstrValue As System.String _
) As IWMPPlaylist
Implements IWMPMediaCollection.getByAttribute

Parameter

bstrAttribute [in]: Die System.String , die das angegebene Attribut ist.
bstrValue [in]: Die System.String , die der angegebene Wert ist.

Rückgabewert

Eine WMPLib.IWMPPlaylist-Schnittstelle für die abgerufenen Medienelemente.

Hinweise

Diese Methode kann verwendet werden, um eine generische Abfrage für Medienelemente zu erstellen, die einem Wert für ein Attribut in der Bibliothek entsprechen. 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 reine Audioelemente
Andere	Andere Elemente, z. B. eine ASF-Datei oder die URL eines Datenstroms.
Foto	Fotoelemente. Erfordert Windows Medienwiedergabe 10.
Playlist	Wiedergabelisten, die als Medienelemente dargestellt werden.
radio	Radiosenderelemente. Wird von Windows Medienwiedergabe 10 nicht verwendet.
video	Videoelemente.

Bevor Sie diese Methode aufrufen, benötigen Sie Lesezugriff auf die Bibliothek. Weitere Informationen finden Sie unter Bibliothekszugriff.

Informationen zu den von Windows Medienwiedergabe unterstützten Attributen finden Sie in der Attributreferenz.

Es gibt zwei Möglichkeiten, wie Sie eine IWMPMediaCollection-Schnittstelle abrufen können, und das Verhalten der getByAttribute-Methode hängt davon ab, welche dieser beiden Methoden Sie verwenden. Wenn Sie die Schnittstelle durch Aufrufen von AxWindowsMediaPlayer.mediaCollection abrufen, gibt die getByAttribute-Methode alle Medienelemente in der Bibliothek zurück. Wenn Sie die Schnittstelle jedoch durch Aufrufen von IWMPLibrary.mediaCollection abrufen, gibt die getByAttribute-Methode nur die Audioelemente in der Bibliothek zurück, die über das angegebene Attribut und den angegebenen Wert verfügen.

Beispiele

Im folgenden Codebeispiel wird getByAttribute verwendet, um alle Inhalte aus der Bibliothek des Künstlers mit dem Namen Triode 48 wiederzugeben. Das AxWMPLib.AxWindowsMediaPlayer-Objekt wird durch die Variable mit dem Namen player dargestellt.

// Get an interface to a playlist that contains media items by a particular artist.
WMPLib.IWMPPlaylist pl = player.mediaCollection.getByAttribute("Artist", "Triode 48");

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

// Play the media items in the current playlist. 
player.Ctlcontrols.play();


' Get an interface to a playlist that contains media items by a particular artist.
Dim pl As WMPLib.IWMPPlaylist = player.mediaCollection.getByAttribute(&quot;Artist&quot;, &quot;Triode 48&quot;)

&#39; Make the new playlist the current one.
player.currentPlaylist = pl

&#39; Play the media items in the current playlist. 
player.Ctlcontrols.play()

Anforderungen

Anforderung	Wert
Version	Windows Medienwiedergabe Serie 9 oder höher
Namespace	WMPLib
Assembly	Interop.WMPLib.dll (Interop.WMPLib.dll.dll)

Siehe auch

IWMPMediaCollection-Schnittstelle (VB und C#)
IWMPPlaylist-Schnittstelle (VB und C#)
IWMPPlaylistCollection.getAll (VB und C#)