IWMPMediaCollection::getByAttribute-Methode

Die getByAttribute-Methode gibt eine IWMPPlaylist-Schnittstelle zurück, die dem angegebenen Attribut entspricht, das den angegebenen Wert aufweist.

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]

Das System.String , das der angegebene Wert ist.

Rückgabewert

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

Bemerkungen

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, führt ein Fehler.

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 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. Nicht von Windows Medienwiedergabe 10 verwendet.
video Videoelemente.

Bevor Sie diese Methode aufrufen, müssen Sie lesezugriff auf die Bibliothek haben. Weitere Informationen finden Sie unter Bibliothekszugriff.

Informationen zu den von Windows Medienwiedergabe unterstützten Attributen finden Sie im Attributverweis.

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 abrufen, indem Sie AxWindowsMediaPlayer.mediaCollection aufrufen, gibt die getByAttribute-Methode alle Medienelemente in der Bibliothek zurück. Wenn Sie jedoch die Schnittstelle abrufen, indem Sie IWMPLibrary.mediaCollection aufrufen, 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 von dem Künstler namens Triode 48 zu wiedergeben. Das AxWMPLib.AxWindowsMediaPlayer-Objekt wird durch die Variable namens 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("Artist", "Triode 48")

' Make the new playlist the current one.
player.currentPlaylist = pl

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

Requirements (Anforderungen)

Anforderung Wert
Version
Windows Medienwiedergabe 9 Serie 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#)