IWMPMediaCollection::getByAttribute (método)

[La característica asociada a esta página, Reproductor multimedia de Windows SDK, es una característica heredada. Se ha reemplazado por MediaPlayer. MediaPlayer se ha optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer en lugar de Reproductor multimedia de Windows SDK, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

El método getByAttribute devuelve una interfaz IWMPPlaylist que corresponde al atributo especificado que tiene el valor especificado.

Sintaxis

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]

System.String que es el atributo especificado.

bstrValue [in]

System.String que es el valor especificado.

Valor devuelto

Interfaz WMPLib.IWMPPlaylist para los elementos multimedia recuperados.

Observaciones

Este método se puede usar para crear una consulta genérica para elementos multimedia que coincidan con un valor para un atributo de la biblioteca. Esto es útil en el caso de atributos definidos por el usuario. Si el atributo no existe, se producirá un error.

Puede usar este método para recuperar todos los elementos multimedia de un tipo específico. Use el nombre de atributo MediaType y uno de los valores siguientes.

Value	Descripción
audio	Música y otros elementos de solo audio
otro	Otros elementos, como un archivo .asf o la dirección URL de una secuencia.
Foto	Artículos de fotos. Requiere Reproductor multimedia de Windows 10.
Reproducción	Listas de reproducción representadas como elementos multimedia.
radio	Artículos de la estación de radio. No se usa en Reproductor multimedia de Windows 10.
video	Elementos de vídeo.

Antes de llamar a este método, debe tener acceso de lectura a la biblioteca. Para obtener más información, consulte Acceso a la biblioteca.

Para obtener información sobre los atributos admitidos por Reproductor multimedia de Windows, vea la Referencia de atributos.

Hay dos maneras de recuperar una interfaz IWMPMediaCollection y el comportamiento del método getByAttribute depende de cuál de esas dos formas de usar. Si recuperas la interfaz llamando a AxWindowsMediaPlayer.mediaCollection, el método getByAttribute devuelve todos los elementos multimedia de la biblioteca. Sin embargo, si recupera la interfaz llamando a IWMPLibrary.mediaCollection, el método getByAttribute devuelve solo los elementos de audio de la biblioteca que tienen el atributo y el valor especificados.

Ejemplos

En el ejemplo de código siguiente se usa getByAttribute para reproducir todo el contenido de la biblioteca por el artista llamado Triode 48. El objeto AxWMPLib.AxWindowsMediaPlayer se representa mediante la variable denominada 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	Value
Versión	Reproductor multimedia de Windows serie 9 o posterior
Espacio de nombres	WMPLib
Ensamblado	Interop.WMPLib.dll (Interop.WMPLib.dll.dll)

Consulte también

Interfaz IWMPMediaCollection (VB y C#)

Interfaz IWMPPlaylist (VB y C#)

IWMPPlaylistCollection.getAll (VB y C#)