IWMPMediaCollection::getByGenre 方法

方法 getByGenre 會傳回 IWMPPlaylist 介面,該介面可讓您存取指定內容類型的媒體專案。

語法

public IWMPPlaylist getByGenre(
  System.String bstrGenre
);

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

參數

bstrGenre [in]

屬於內容類型名稱的 System.String

傳回值

所擷取媒體專案的 WMPLib.IWMPPlaylist 介面。

備註

呼叫這個方法之前,您必須具有程式庫的讀取權限。 如需詳細資訊,請參閱 程式庫存取

有兩種方式可讓您擷 取 IWMPMediaCollection 介面,而方法的行為 getByGenre 取決於您使用的兩種方式之一。 如果您藉由呼叫 AxWindowsMediaPlayer.mediaCollection來擷取介面,則 getByGenre 方法會傳回程式庫中的所有媒體專案。 不過,如果您藉由呼叫 IWMPLibrary.mediaCollection來擷取介面,則 getByGenre 方法只會傳回程式庫中具有指定屬性和值的音訊專案。

範例

下列範例會在使用者按一下按鈕時,使用 getByGenre 來擷取媒體專案的播放清單。 播放清單包含文字方塊中使用者所指定內容類型的專案。 AxWMPLib.AxWindowsMediaPlayer物件是由名為 player 的變數表示。

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

規格需求

需求
版本
Windows 媒體播放機 9 系列或更新版本
命名空間
WMPLib
組件
Interop.WMPLib.dll (Interop.WMPLib.dll.dll)

另請參閱

IWMPMediaCollection 介面 (VB 和 C#)

IWMPPlaylist 介面 (VB 和 C#)