Método IWMPMediaCollection::getByAttribute

[O recurso associado a esta página, Reprodutor Multimídia do Windows SDK, é um recurso herdado. Foi substituído pelo MediaPlayer. O MediaPlayer foi otimizado para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use o MediaPlayer em vez de Reprodutor Multimídia do Windows SDK, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O método getByAttribute retorna uma interface IWMPPlaylist que corresponde ao atributo especificado que tem o valor especificado.

Sintaxe

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

Parâmetros

bstrAttribute [in]

O System.String que é o atributo especificado.

bstrValue [in]

O System.String que é o valor especificado.

Retornar valor

Uma interface WMPLib.IWMPPlaylist para os itens de mídia recuperados.

Comentários

Esse método pode ser usado para criar uma consulta genérica para itens de mídia que correspondam a um valor para um atributo na biblioteca. Isso é útil no caso de atributos definidos pelo usuário. Se o atributo não existir, um erro resultará.

Você pode usar esse método para recuperar todos os itens de mídia de um tipo específico. Use o nome do atributo MediaType e um dos valores a seguir.

Valor	Descrição
áudio	Música e outros itens somente áudio
other	Outros itens, como um arquivo .asf ou a URL de um fluxo.
foto	Itens de foto. Requer Reprodutor Multimídia do Windows 10.
playlist	Playlists representadas como itens de mídia.
radio	Itens de estação de rádio. Não usado pelo Reprodutor Multimídia do Windows 10.
video	Itens de vídeo.

Antes de chamar esse método, você deve ter acesso de leitura à biblioteca. Para obter mais informações, consulte Acesso à biblioteca.

Para obter informações sobre os atributos compatíveis com Reprodutor Multimídia do Windows, consulte a Referência de Atributo.

Há duas maneiras de recuperar uma interface IWMPMediaCollection e o comportamento do método getByAttribute depende de quais dessas duas maneiras você usa. Se você recuperar a interface chamando AxWindowsMediaPlayer.mediaCollection, o método getByAttribute retornará todos os itens de mídia na biblioteca. No entanto, se você recuperar a interface chamando IWMPLibrary.mediaCollection, o método getByAttribute retornará apenas os itens de áudio na biblioteca que têm o atributo e o valor especificados.

Exemplos

O exemplo de código a seguir usa getByAttribute para reproduzir todo o conteúdo da biblioteca pelo artista chamado Triode 48. O objeto AxWMPLib.AxWindowsMediaPlayer é representado pela variável chamada 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()

Requisitos

Requisito	Valor
Versão	série Reprodutor Multimídia do Windows 9 ou posterior
Namespace	WMPLib
Assembly	Interop.WMPLib.dll (Interop.WMPLib.dll.dll)

Confira também

Interface IWMPMediaCollection (VB e C#)

Interface IWMPPlaylist (VB e C#)

IWMPPlaylistCollection.getAll (VB e C#)