IWMPMediaCollection::getByGenre-Methode

Die getByGenre -Methode gibt eine IWMPPlaylist-Schnittstelle zurück, die Zugriff auf Medienelemente des angegebenen Genre bereitstellt.

Syntax

public IWMPPlaylist getByGenre(
  System.String bstrGenre
);

Public Function getByGenre( _
  ByVal bstrGenre As System.String _
) As IWMPPlaylist
Implements IWMPMediaCollection.getByGenre

Parameter

bstrGenre [ In]

Die System.String, die der Name des Genre ist.

Rückgabewert

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

Bemerkungen

Vor dem Aufrufen dieser Methode benötigen Sie Lesezugriff auf die Bibliothek. Weitere Informationen finden Sie unter Bibliothekszugriff.

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

Beispiele

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

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

    // Create the playlist using getByGenre. 
    WMPLib.IWMPPlaylist pl = player.mediaCollection.getByGenre(genre);

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

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

Public Sub playGenre_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles playGenre.Click

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

    ' Retrieve the genre that the user entered in the text box. 
    Dim genre As String = getGenre.Text

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

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

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

End Sub

Requirements (Anforderungen)

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

Weitere Informationen

IWMPMediaCollection-Schnittstelle (VB und C#)

IWMPPlaylist-Schnittstelle (VB und C#)