IWMPMediaCollection::getByAttribute-Methode
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.
Bemerkungen
Diese Methode kann verwendet werden, um eine generische Abfrage für Medienelemente zu erstellen, die mit einem Wert für ein Attribut in der Bibliothek ü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 |
| Andere | Andere Elemente, z. B. eine ASF-Datei oder die URL eines Streams. |
| Foto | Fotoelemente. Erfordert Windows Media Player 10. |
| Playlist | Wiedergabelisten, die als Medienelemente dargestellt werden. |
| radio | Radiostationselemente. Wird von Windows Media Player 10 nicht verwendet. |
| video | Videoelemente. |
Bevor Sie diese Methode aufrufen, müssen Sie über Lesezugriff auf die Bibliothek verfügen. Weitere Informationen finden Sie unter Bibliothekszugriff.
Informationen zu den Attributen, die von Windows Media Player unterstützt werden, 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.mediaCollectionabrufen, gibt die getByAttribute-Methode alle Medienelemente in der Bibliothek zurück. Wenn Sie die Schnittstelle jedoch durch Aufrufen von IWMPLibrary.mediaCollectionabrufen, 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 Interpreten namens Attributde 48 wieder zu spielen. Das AxWMPLib.AxWindowsMediaPlayer-Objekt wird durch die Variable 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 Media Player 9-Serie oder höher |
| Namespace |
WMPLib |
| Assembly |
|