IWMPMediaCollection::getByAttribute 方法

getByAttribute方法會傳回IWMPPlaylist介面,該介面會對應至具有指定值之指定屬性。

語法

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

參數

bstrAttribute [in]

屬於指定屬性的 System.String

bstrValue [in]

指定值的 System.String

傳回值

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

備註

這個方法可用來為媒體專案建立泛型查詢,以符合程式庫中屬性的值。 這在使用者定義屬性的情況下很有用。 如果屬性不存在,將會產生錯誤。

您可以使用這個方法來擷取特定類型的所有媒體專案。 使用屬性名稱 MediaType 和下列其中一個值。

描述
音訊 音樂和其他僅限音訊的專案
其他 其他專案,例如 .asf 檔案或資料流程的 URL。
相片 相片專案。 需要 Windows 媒體播放機 10。
播放清單 以媒體專案表示的播放清單。
radio 無線電站專案。 Windows 媒體播放機 10 未使用。
影片 視訊專案。

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

如需Windows 媒體播放機所支援之屬性的相關資訊,請參閱屬性參考

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

範例

下列程式碼範例會使用 getByAttribute ,由名為 Triode 48 的作者從文件庫播放所有內容。 AxWMPLib.AxWindowsMediaPlayer物件是由名為 player 的變數表示。

// 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()

規格需求

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

另請參閱

IWMPMediaCollection 介面 (VB 和 C#)

IWMPPlaylist 介面 (VB 和 C#)

IWMPPlaylistCollection.getAll (VB 和 C#)