IWMPMediaCollection::getByAlbum-Methode

[Das dieser Seite zugeordnete Feature Windows Medienwiedergabe SDK ist ein Legacyfeature. Es wurde von MediaPlayer ersetzt. MediaPlayer wurde für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, nach Möglichkeit für neuen Code MediaPlayer anstelle von Windows Medienwiedergabe SDK zu verwenden. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die getByAlbum-Methode gibt eine IWMPPlaylist-Schnittstelle zurück, die zugriff auf Medienelemente aus dem angegebenen Album ermöglicht.

Syntax

public IWMPPlaylist getByAlbum(
  System.String bstrAlbum
);

Public Function getByAlbum( _
  ByVal bstrAlbum As System.String _
) As IWMPPlaylist
Implements IWMPMediaCollection.getByAlbum

Parameter

bstrAlbum [in]

Der System.String-Titel des Albums.

Rückgabewert

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

Bemerkungen

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

Es gibt zwei Möglichkeiten, eine IWMPMediaCollection-Schnittstelle abzurufen, und das Verhalten der getByAlbum-Methode hängt davon ab, welche dieser beiden Methoden Sie verwenden. Wenn Sie die Schnittstelle durch Aufrufen von AxWindowsMediaPlayer.mediaCollection abrufen, gibt die getByAlbum-Methode alle Medienelemente in der Bibliothek zurück. Wenn Sie die Schnittstelle jedoch durch Aufrufen von IWMPLibrary.mediaCollection abrufen, gibt die getByAlbum-Methode nur die Audioelemente in der Bibliothek zurück, die zum angegebenen Album gehören.

Beispiele

Im folgenden Beispiel wird getByAlbum verwendet, um eine Wiedergabeliste mit Medienelementen zu erstellen, wenn der Benutzer auf eine Schaltfläche klickt. Die Wiedergabeliste enthält Elemente mit dem album, das vom Benutzer in einem Textfeld angegeben wurde. Das AxWMPLib.AxWindowsMediaPlayer-Objekt wird durch die Variable player dargestellt.

private void playAlbum_Click(object sender, System.EventArgs e)
{ 
    // ...Add code to ensure that the text box contains a valid value.
 
    // Retrieve the album title text that the user entered in the text box. 
    string album = getAlbum.Text;

    // Create the playlist using getByAlbum. 
    WMPLib.IWMPPlaylist pl = player.mediaCollection.getByAlbum(album);

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

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

Public Sub playAlbum_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles playAlbum.Click

    ' ...Add code to ensure that the text box contains a valid value.

    ' Retrieve the album title text that the user entered in the text box. 
    Dim album As String = getAlbum.Text

    ' Create the playlist using getByAlbum. 
    Dim pl As WMPLib.IWMPPlaylist = player.mediaCollection.getByAlbum(album)

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

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

End Sub

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#)