Metodo IWMPMediaCollection::getByAttribute

Il metodo getByAttribute restituisce un'interfaccia IWMPPlaylist corrispondente all'attributo specificato con il valore specificato.

Sintassi

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

Parametri

bstrAttribute [in]

Attributo System.String specificato.

bstrValue [in]

System.String che corrisponde al valore specificato.

Valore restituito

Interfaccia WMPLib.IWMPPlaylist per gli elementi multimediali recuperati.

Commenti

Questo metodo può essere usato per creare una query generica per gli elementi multimediali che corrispondono a un valore per un attributo nella libreria. Questo è utile nel caso di attributi definiti dall'utente. Se l'attributo non esiste, verrà generato un errore.

È possibile usare questo metodo per recuperare tutti gli elementi multimediali di un tipo specifico. Usare il nome dell'attributo MediaType e uno dei valori seguenti.

Valore Descrizione
Audio Musica e altri elementi audio
altro Altri elementi, ad esempio un file asf o l'URL di un flusso.
Foto Elementi fotografici. Richiede Lettore multimediale Windows 10.
Playlist Playlist rappresentate come elementi multimediali.
radio Elementi della stazione radio. Non usato da Lettore multimediale Windows 10.
Video Elementi video.

Prima di chiamare questo metodo, è necessario avere accesso in lettura alla libreria. Per altre informazioni, vedere Accesso alla libreria.

Per informazioni sugli attributi supportati da Lettore multimediale Windows, vedere Informazioni di riferimento sull'attributo.

Esistono due modi per recuperare un'interfaccia IWMPMediaCollection e il comportamento del metodo getByAttribute dipende da quali due modi si usa. Se si recupera l'interfaccia chiamando AxWindowsMediaPlayer.mediaCollection, il metodo getByAttribute restituisce tutti gli elementi multimediali della libreria. Tuttavia, se si recupera l'interfaccia chiamando IWMPLibrary.mediaCollection, il metodo getByAttribute restituisce solo gli elementi audio della libreria con l'attributo e il valore specificati.

Esempio

Nell'esempio di codice seguente viene usato getByAttribute per riprodurre tutto il contenuto dalla libreria dall'artista denominato Triode 48. L'oggetto AxWMPLib.AxWindowsMediaPlayer è rappresentato dalla variabile denominata 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()

Requisiti

Requisito Valore
Versione
Lettore multimediale Windows serie 9 o versioni successive
Spazio dei nomi
WMPLib
Assembly
Interop.WMPLib.dll (Interop.WMPLib.dll.dll)

Vedi anche

Interfaccia IWMPMediaCollection (VB e C#)

Interfaccia IWMPPlaylist (VB e C#)

IWMPPlaylistCollection.getAll (VB e C#)