IWMPMediaCollection::getByAttribute (método)

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.

Comentarios

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 Valor
Versión
Reproductor multimedia de Windows serie 9 o posterior
Espacio de nombres
WMPLib
Ensamblado
Interop.WMPLib.dll (Interop.WMPLib.dll.dll)

Vea también

Interfaz IWMPMediaCollection (VB y C#)

Interfaz IWMPPlaylist (VB y C#)

IWMPPlaylistCollection.getAll (VB y C#)